MGModel Gate
ΣυνδεθείτεΞεκινήστε

Επανακλήσεις

Λάβετε υπογεγραμμένες ειδοποιήσεις διακομιστή σε διακομιστή και ολοκληρωμένα αποτελέσματα ασυγχρονισμού.

Επανακλήσεις

Διαμόρφωση διεύθυνσης URL επιστροφής κλήσης Προφίλ → Επιστροφές κλήσεων και ασύγχρονα αποτελέσματα. Το Model Gate στέλνει HTTPS POST αιτήματα για ενεργοποιημένες ειδοποιήσεις λογαριασμού και για ολοκληρωμένα ασύγχρονα αιτήματα συμπερασμάτων.

URL επιστροφής κλήσης

Χρησιμοποιήστε ένα δημοσίως προσβάσιμο τελικό σημείο HTTPS. Το τελικό σημείο θα πρέπει να διαβάζει το σώμα του μη επεξεργασμένου αιτήματος, να επαληθεύει την υπογραφή, να επεξεργάζεται το συμβάν ανεπαρκώς και να επιστρέφει HTTP 200 μόλις γίνει αποδεκτή η εκδήλωση.

Εκδηλώσεις

Οι επανακλήσεις μπορεί να περιλαμβάνουν:

  • συμπληρωμένα ασύγχρονα αποτελέσματα συμπερασμάτων.
  • ειδοποιήσεις χαμηλού υπολοίπου λογαριασμού όταν είναι ενεργοποιημένες.
  • Ειδοποιήσεις ορίου δαπανών κλειδιού API όταν είναι ενεργοποιημένες.
  • ειδοποιήσεις ορίου δαπανών βασικών ομάδων όταν είναι ενεργοποιημένες.

Η ασύγχρονη παράδοση αποτελεσμάτων ενεργοποιείται κάθε φορά που διαμορφώνεται μια διεύθυνση URL επιστροφής κλήσης. Τα πλαίσια ελέγχου ειδοποιήσεων στο Προφίλ ελέγχουν μόνο τις αντίστοιχες ειδοποιήσεις υπολοίπου και περιορισμού.

Μορφή αιτήματος

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

Παράδειγμα ωφέλιμου φορτίου ασύγχρονου αποτελέσματος:

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

Τα πεδία ωφέλιμου φορτίου μπορούν να επεκταθούν με την πάροδο του χρόνου. Αγνοήστε άγνωστα πεδία.

Επαλήθευση υπογραφής

Η κεφαλίδα της υπογραφής έχει αυτή τη μορφή:

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

Υπολογίστε το HMAC-SHA256 πάνω από την ακριβή συμβολοσειρά <timestamp>.<raw_body> χρησιμοποιώντας το μυστικό επανάκλησης που εμφανίζεται στο Προφίλ. Συγκρίνετε τη δεκαεξαδική υπογραφή με μια σύγκριση σταθερού χρόνου και απορρίψτε τις χρονικές σημάνσεις έξω από το αποδεκτό παράθυρο επανάληψης.

Παράδοση και επαναλήψεις

Επιστροφή HTTP 200 αφού αποδεχτεί με ασφάλεια την εκδήλωση. Οι αποκρίσεις που δεν είναι 2xx και οι αποτυχίες σύνδεσης μπορούν να επαναληφθούν. Ως εκ τούτου, το τελικό σας σημείο πρέπει να είναι ανίκανο. χρήση request_id μαζί με event ως κλειδί αποδιπλασιασμού.

Μην εκτελείτε μακροχρόνιες εργασίες πριν απαντήσετε. Ουρά εσωτερικά του συμβάντος, επιστροφή 200, και να το επεξεργαστείτε ασύγχρονα.

Σχετική τεκμηρίωση