MGModel Gate
Jelentkezzen beKezdje el

Visszahívások

Aláírt kiszolgálók közötti értesítések és befejezett aszinkronizálási eredmények fogadása.

Visszahívások

Konfiguráljon egy visszahívási URL-t Profil → Visszahívások és aszinkron eredmények. A Model Gate HTTPS-t küld POST kérések az engedélyezett fiókértesítésekre és a befejezett aszinkron következtetési kérésekre.

Visszahívási URL

Használjon nyilvánosan elérhető HTTPS-végpontot. A végpontnak be kell olvasnia a nyers kérés törzsét, ellenőriznie kell az aláírást, idempotensen kell feldolgoznia az eseményt, és vissza kell adnia a HTTP-t 200 amint az eseményt elfogadták.

Események

A visszahívások a következőket tartalmazhatják:

  • befejezett aszinkron következtetési eredmények;
  • alacsony számlaegyenleg-értesítések, ha engedélyezve van;
  • API-kulcs kiadási limit értesítések, ha engedélyezve van;
  • kulcscsoportos kiadási limit értesítések, ha engedélyezve van.

A visszahívási URL konfigurálásakor az aszinkron eredménykézbesítés engedélyezve van. A Profil értesítési jelölőnégyzetei csak a megfelelő egyenleg- és limitfigyelmeztetéseket szabályozzák.

Kérelem formátuma

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

Példa aszinkron eredményre:

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

A hasznos tehermezők idővel bővíthetők. Az ismeretlen mezők figyelmen kívül hagyása.

Aláírás ellenőrzése

Az aláírás fejlécének formátuma a következő:

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

Számítsa ki a HMAC-SHA256-ot a pontos karakterlánc alapján <timestamp>.<raw_body> a Profilban látható visszahívási titok használatával. Hasonlítsa össze a hexadecimális aláírást egy állandó idejű összehasonlítással, és utasítsa el az időbélyegeket az elfogadott visszajátszási ablakon kívül.

Szállítás és újrapróbálkozás

HTTP visszaadása 200 miután biztonságosan elfogadta az eseményt. A nem 2xx válaszokat és a csatlakozási hibákat újra meg lehet próbálni. Ezért a végpontjának idempotensnek kell lennie; használat request_id együtt event deduplikációs kulcsként.

Válaszadás előtt ne végezzen hosszan tartó munkát. Az esemény belső sorba állítása, visszatérés 200, és aszinkron módon dolgozza fel.

Kapcsolódó dokumentáció