MGModel Gate
Logi sisseAlustage

Tagasihelistamised

Saate allkirjastatud serveritevahelisi teatisi ja lõpetatud asünkroonimise tulemusi.

Tagasihelistamised

Seadistage tagasihelistamise URL Profiil → Tagasihelistamised ja asünkroonimise tulemused. Model Gate saadab HTTPS-i POST päringud lubatud konto märguannete ja lõpetatud asünkroonsete järelduste päringute kohta.

Tagasihelistamise URL

Kasutage avalikult juurdepääsetavat HTTPS-i lõpp-punkti. Lõpp-punkt peaks lugema töötlemata päringu keha, kontrollima allkirja, töötlema sündmust idempotsionaalselt ja tagastama HTTP 200 as soon as the event has been accepted.

Sündmused

Tagasihelistamine võib hõlmata järgmist:

  • lõpetatud asünkroonsed järeldused;
  • madala kontojäägi märguanded, kui see on lubatud;
  • API-võtme kululimiidi märguanded, kui see on lubatud;
  • võtmerühma kululimiidi märguanded, kui see on lubatud.

Tulemuste asünkroonimine on lubatud alati, kui tagasihelistamise URL on konfigureeritud. Teavituste märkeruudud profiilis juhivad ainult vastavaid saldo- ja limiidimärguandeid.

Taotluse vorming

POST /model-gate/callback HTTP/1.1
Content-Type: application/json
X-Model-Gate-Signature: t=1710000000,v1=hex_hmac_sha256

Asünkroonimistulemuste kasuliku koormuse näide:

{
  "event":"async.completed",
  "request_id":"01J...",
  "status":"completed",
  "response":{"id":"msg_...","type":"message"}
}

Kasuliku koormuse välju saab aja jooksul pikendada. Ignoreeri tundmatuid välju.

Allkirja kinnitamine

Allkirja päis on järgmises vormingus:

X-Model-Gate-Signature: t=<unix>,v1=<hmac_sha256>

Arvutage HMAC-SHA256 täpse stringi järgi <timestamp>.<raw_body> kasutades profiilis näidatud tagasihelistamissaladusi. Võrrelge kuueteistkümnendsüsteemi allkirja konstantse aja võrdlusega ja lükake väljaspool aktsepteeritud taasesituse akent tagasi ajatemplid.

Kohaletoimetamine ja uuesti proovimine

Tagasta HTTP 200 pärast sündmuse turvalist vastuvõtmist. Mitte-2xx vastuseid ja ühenduse tõrkeid võib uuesti proovida. Seetõttu peab teie lõpp-punkt olema idempotentne; kasutada request_id koos event deduplikatsioonivõtmena.

Ärge tehke enne vastamist pikaajalist tööd. Pange sündmus sisemisse järjekorda, pöörduge tagasi 200ja töödelda seda asünkroonselt.

Seotud dokumentatsioon