MGModel Gate
RegistrazioneInizia

Richiamate

Ricevi notifiche server-server firmate e risultati asincroni completati.

Richiamate

Configura un URL di richiamata in Profilo → Richiamate e risultati asincroni. Model Gate invia HTTPS POST richieste di notifiche di account abilitate e di richieste di inferenza asincrona completate.

URL di richiamata

Utilizza un endpoint HTTPS raggiungibile pubblicamente. L'endpoint dovrebbe leggere il corpo della richiesta non elaborata, verificare la firma, elaborare l'evento in modo idempotente e restituire HTTP 200 non appena l'evento è stato accettato.

Eventi

Le richiamate possono includere:

  • risultati dell'inferenza asincrona completati;
  • notifiche di saldo del conto basso quando abilitato;
  • Notifiche sui limiti di spesa della chiave API quando abilitate;
  • notifiche sui limiti di spesa del gruppo chiave quando abilitate.

Il recapito asincrono dei risultati è abilitato ogni volta che viene configurato un URL di richiamata. Le caselle di notifica nel Profilo controllano solo gli avvisi di saldo e limite corrispondenti.

Richiedi formato

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

Esempio di payload del risultato asincrono:

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

I campi del carico utile possono essere estesi nel tempo. Ignora i campi sconosciuti.

Verifica della firma

L'intestazione della firma ha questo formato:

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

Calcola HMAC-SHA256 sulla stringa esatta <timestamp>.<raw_body> utilizzando il segreto di richiamata mostrato in Profile. Confronta la firma esadecimale con un confronto a tempo costante e rifiuta i timestamp al di fuori della finestra di riproduzione accettata.

Consegna e tentativi

Restituisce HTTP 200 dopo aver accettato in sicurezza l'evento. È possibile ritentare le risposte non 2xx e gli errori di connessione. Il tuo endpoint deve quindi essere idempotente; utilizzo request_id insieme a event come chiave di deduplicazione.

Non eseguire lavori di lunga durata prima di rispondere. Accoda l'evento internamente, ritorna 200ed elaborarlo in modo asincrono.

Documentazione correlata