MGModel Gate
Prihláste saZačnite

Spätné volania

Prijímať podpísané oznámenia medzi servermi a dokončené výsledky asynchronizácie.

Spätné volania

Nakonfigurujte adresu URL spätného volania v Profil → Spätné volania a asynchronné výsledky. Model Gate odosiela HTTPS POST požiadavky na aktivované upozornenia účtu a na dokončené asynchrónne vyvodzovacie požiadavky.

Adresa URL spätného volania

Použite verejne dostupný koncový bod HTTPS. Koncový bod by mal prečítať nespracované telo požiadavky, overiť podpis, spracovať udalosť idempotentne a vrátiť HTTP 200 hneď po prijatí udalosti.

Udalosti

Spätné volania môžu zahŕňať:

  • dokončené výsledky asynchrónnej inferencie;
  • upozornenia na nízky zostatok na účte, keď sú povolené;
  • upozornenia na limit výdavkov na kľúč API, keď sú povolené;
  • upozornenia na limit výdavkov kľúčovej skupiny, keď sú povolené.

Asynchrónne doručovanie výsledkov je povolené vždy, keď je nakonfigurovaná adresa URL spätného volania. Začiarkavacie políčka upozornení v profile ovládajú iba zodpovedajúce upozornenia zostatku a limitov.

Formát žiadosti

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

Príklad obsahu asynchrónneho výsledku:

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

Polia užitočného zaťaženia sa môžu časom rozširovať. Ignorovať neznáme polia.

Overenie podpisu

Hlavička podpisu má tento formát:

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

Vypočítajte HMAC-SHA256 cez presný reťazec <timestamp>.<raw_body> pomocou tajného volania zobrazeného v Profile. Porovnajte hexadecimálny podpis s porovnaním s konštantným časom a odmietnite časové pečiatky mimo vášho akceptovaného okna prehrávania.

Doručenie a opakované pokusy

Vrátiť HTTP 200 po bezpečnom prijatí udalosti. Odpovede iné ako 2xx a zlyhania pripojenia sa môžu opakovať. Váš koncový bod preto musí byť idempotentný; použitie request_id spolu s event ako deduplikačný kľúč.

Pred reakciou nevykonávajte dlhotrvajúcu prácu. Interne zaradiť udalosť do frontu, vrátiť sa 200a spracovať ho asynchrónne.

Súvisiaca dokumentácia