MGModel Gate
Log inGa aan de slag

Terugbelgesprekken

Ontvang ondertekende server-naar-server-meldingen en voltooide asynchrone resultaten.

Terugbelgesprekken

Configureer een terugbel-URL in Profiel → Terugbelgesprekken en asynchrone resultaten. Model Gate verzendt HTTPS POST verzoeken voor ingeschakelde accountmeldingen en voor voltooide asynchrone inferentieverzoeken.

Terugbel-URL

Gebruik een openbaar bereikbaar HTTPS-eindpunt. Het eindpunt moet de onbewerkte aanvraagtekst lezen, de handtekening verifiëren, de gebeurtenis idempotent verwerken en HTTP retourneren 200 zodra het evenement is geaccepteerd.

Evenementen

Terugbelverzoeken kunnen het volgende omvatten:

  • voltooide asynchrone inferentieresultaten;
  • meldingen over laag rekeningsaldo indien ingeschakeld;
  • Meldingen over API-sleutelbestedingslimieten indien ingeschakeld;
  • bestedingslimietmeldingen voor sleutelgroepen indien ingeschakeld.

Asynchrone levering van resultaten wordt ingeschakeld wanneer een callback-URL is geconfigureerd. De meldingsvakjes in Profiel beheren alleen de overeenkomstige saldo- en limietwaarschuwingen.

Aanvraag formaat

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

Voorbeeld van een asynchrone resultaatpayload:

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

Payloadvelden kunnen in de loop van de tijd worden uitgebreid. Negeer onbekende velden.

Handtekeningverificatie

De handtekeningkop heeft dit formaat:

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

Bereken HMAC-SHA256 over de exacte string <timestamp>.<raw_body> met behulp van het terugbelgeheim dat wordt weergegeven in Profiel. Vergelijk de hexadecimale handtekening met een constante-tijdvergelijking en wijs tijdstempels buiten uw geaccepteerde herhalingsvenster af.

Bezorging en nieuwe pogingen

HTTP retourneren 200 na het veilig accepteren van de gebeurtenis. Niet-2xx-reacties en verbindingsfouten kunnen opnieuw worden geprobeerd. Uw eindpunt moet daarom idempotent zijn; gebruik request_id samen met event als deduplicatiesleutel.

Voer geen langdurig werk uit voordat u reageert. Zet de gebeurtenis intern in de wachtrij en keer terug 200en verwerk het asynchroon.

Gerelateerde documentatie