MGModel Gate
Log indKom i gang

Tilbagekald

Modtag signerede server-til-server-meddelelser og gennemførte asynkroniseringsresultater.

Tilbagekald

Konfigurer en tilbagekalds-URL i Profil → Tilbagekald og asynkroniserede resultater. Model Gate sender HTTPS POST anmodninger om aktiverede kontomeddelelser og for afsluttede anmodninger om asynkrone slutninger.

Callback URL

Brug et offentligt tilgængeligt HTTPS-slutpunkt. Slutpunktet skal læse den rå anmodningstekst, verificere signaturen, behandle hændelsen idempotent og returnere HTTP 200 så snart arrangementet er blevet accepteret.

Begivenheder

Tilbagekald kan omfatte:

  • afsluttede asynkrone inferensresultater;
  • meddelelser om lav kontosaldo, når den er aktiveret;
  • API-nøgle forbrugsgrænse-meddelelser, når aktiveret;
  • notifikationer om nøglegruppeforbrugsgrænser, når det er aktiveret.

Levering af asynkron resultat er aktiveret, hver gang en tilbagekalds-URL er konfigureret. Meddelelsesafkrydsningsfelterne i Profil styrer kun de tilsvarende saldo- og grænseadvarsler.

Anmodningsformat

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

Eksempel på nyttelast for asynkront resultat:

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

Nyttelastfelter kan udvides over tid. Ignorer ukendte felter.

Signaturbekræftelse

Signaturoverskriften har dette format:

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

Beregn HMAC-SHA256 over den nøjagtige streng <timestamp>.<raw_body> ved hjælp af tilbagekaldshemmeligheden vist i Profil. Sammenlign den hexadecimale signatur med en sammenligning med konstant tid, og afvis tidsstempler uden for dit accepterede genafspilningsvindue.

Levering og genforsøg

Returner HTTP 200 efter sikkert at have accepteret begivenheden. Ikke-2xx-svar og forbindelsesfejl kan prøves igen. Dit endepunkt skal derfor være idempotent; bruge request_id sammen med event som en deduplikeringsnøgle.

Udfør ikke langvarigt arbejde, før du reagerer. Stil begivenheden i kø internt, vend tilbage 200, og behandle det asynkront.

Relateret dokumentation