MGModel Gate
PierakstītiesSāciet darbu

Atzvani

Saņemiet parakstītus starpserveru paziņojumus un pabeigtos asinhronizācijas rezultātus.

Atzvani

Konfigurējiet atzvanīšanas URL Profils → Atzvani un asinhronie rezultāti. Modeļa vārti nosūta HTTPS POST pieprasījumi par iespējotiem konta paziņojumiem un pabeigtiem asinhrono secinājumu pieprasījumiem.

Atzvanīšanas URL

Izmantojiet publiski pieejamu HTTPS galapunktu. Galapunktam ir jāizlasa neapstrādātā pieprasījuma pamatteksts, jāpārbauda paraksts, jāapstrādā notikums ideāli un jāatgriež HTTP 200 tiklīdz pasākums ir pieņemts.

Pasākumi

Atzvani var ietvert:

  • pabeigti asinhrono secinājumu rezultāti;
  • paziņojumi par zemu konta atlikumu, kad tas ir iespējots;
  • API atslēgas tēriņu limita paziņojumi, kad tas ir iespējots;
  • atslēgu grupas tēriņu limita paziņojumi, kad tas ir iespējots.

Asinhronā rezultātu piegāde ir iespējota ikreiz, kad ir konfigurēts atzvanīšanas URL. Paziņojumu izvēles rūtiņas sadaļā Profils kontrolē tikai atbilstošos bilances un ierobežojumu brīdinājumus.

Pieprasījuma formāts

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

Asinhrono rezultātu lietderīgās slodzes piemērs:

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

Derīgās slodzes laukus laika gaitā var pagarināt. Ignorēt nezināmos laukus.

Paraksta pārbaude

Paraksta galvenes formāts ir šāds:

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

Aprēķiniet HMAC-SHA256, izmantojot precīzu virkni <timestamp>.<raw_body> izmantojot profilā redzamo atzvanīšanas noslēpumu. Salīdziniet heksadecimālo parakstu ar konstanta laika salīdzinājumu un noraidiet laikspiedolus ārpus pieņemtā atkārtošanas loga.

Piegāde un atkārtojumi

Atgriezt HTTP 200 pēc drošas pasākuma pieņemšanas. Atbildes, kas nav 2xx, un savienojuma kļūmes var mēģināt atkārtoti. Tāpēc jūsu galapunktam ir jābūt idempotentam; izmantot request_id kopā ar event kā dublēšanas atslēgu.

Pirms atbildes neveiciet ilgstošu darbu. Ievietojiet notikumu iekšēji rindā, atgriezieties 200, un apstrādājiet to asinhroni.

Saistītā dokumentācija