Partner API Συνήθεις ερωτήσεις

Ποια είναι η διαφορά μεταξύ ενός κλειδιού API λογαριασμού και ενός κλειδιού API μοντέλου;

Το κλειδί API σε επίπεδο λογαριασμού (mg_partner_...) διαχειρίζεται τα κλειδιά API μοντέλου μέσω https://p-api.model-gate.com/api/v1/partner/* και ανακτά ασύγχρονα αποτελέσματα μέσω https://p-api.model-gate.com/api/v1/requests/{request_public_id}.

Ένα κλειδί API μοντέλου (mg_live_...) επαληθεύει τα αιτήματα συμπερασμάτων μέσω https://api.model-gate.com.

Ποτέ μην στέλνετε κλειδί Partner API σε επίπεδο λογαριασμού σε ένα τελικό σημείο συμπερασμάτων και μην το εκθέτετε σε εφαρμογές πελάτη.

Ποιος μετρητής επιβάλλει spend_limit?

Το επαναρυθμιζόμενο usage ο μετρητής επιβάλλει το όριο. POST /api/v1/partner/keys/{key_public_id}/reset-usage διαγράφει το κλειδί μετρητή. total_spent είναι λογιστική εφ' όρου ζωής και δεν γίνεται ποτέ επαναφορά.

Κάθε κλειδί API μοντέλου έχει ξεχωριστό υπόλοιπο λογαριασμού;

Όχι. Όλα τα κλειδιά API μοντέλων ξοδεύονται από το υπόλοιπο του λογαριασμού Model Gate. Τα όρια ανά κλειδί και ομάδα περιορίζουν τη χρήση χωρίς να χωρίζουν το υπόλοιπο του λογαριασμού σε θυγατρικά υπόλοιπα.

Τι συμβαίνει όταν ένα κλειδί API μοντέλου περιστρέφεται;

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

Πώς διαμορφώνονται οι επανακλήσεις;

Διαμόρφωση callback_url και περιστρέψτε callback_secret στο προφίλ Model Gate. Τα αποτελέσματα ασύγχρονης ολοκλήρωσης αποστέλλονται όταν υπάρχει μια διεύθυνση URL επιστροφής κλήσης. Προαιρετικά συμβάντα χαμηλών τόνων, ορίου ομάδας κλειδιών και χαμηλού υπολοίπου λογαριασμού μπορούν να ενεργοποιηθούν χωριστά. τα όριά τους διαμορφώνονται στις ειδοποιήσεις προφίλ.

Η παράδοση επανάκλησης είναι ανθεκτική και ανεξάρτητη από την επεξεργασία συμπερασμάτων. Κάθε εκδήλωση κουβαλά ένα στάβλο event_id που παραμένει αμετάβλητο στις επαναλήψεις και πρέπει να χρησιμοποιείται για την αφαίρεση διπλότυπων καταναλωτών. Οποιοδήποτε HTTP 2xx η απάντηση είναι επιτυχής. Η παράδοση χρησιμοποιεί το πολύ 6 προσπάθειες συνολικά, με επαναλήψεις μετά από 5 δευτερόλεπτα, 30 δευτερόλεπτα, 2 λεπτά, 10 λεπτά και 1 ώρα. κάθε προσπάθεια έχει συνολικό τάιμ άουτ 15 δευτερολέπτων. Τα σφάλματα μεταφοράς, τα χρονικά όρια και οι απαντήσεις που δεν είναι 2xx δοκιμάζονται ξανά και μετά την έκτη αποτυχημένη προσπάθεια το συμβάν επισημαίνεται failed χωρίς περαιτέρω αυτόματη επανάληψη. Βλέπω Επανακλήσεις για τον κατάλογο εκδηλώσεων, ακριβή δεκαδικά ωφέλιμα φορτία, υπογραφές, ασφάλεια προορισμού και λεπτομέρειες παράδοσης.

Πόσο καιρό μπορεί να ανακτηθεί ένα ασύγχρονο αποτέλεσμα;

Ένα ασύγχρονο αποτέλεσμα παραμένει διαθέσιμο για 24 ώρες GET https://p-api.model-gate.com/api/v1/requests/{request_public_id}. Μετά τη λήξη, το αποθηκευμένο αίτημα και η απάντηση διαγράφονται και το τελικό σημείο επιστρέφει 404.

Υποστηρίζουν οι μεταλλάξεις συνεργατών την ασφαλή επανάληψη;

Ναί. Κάθε Partner API POST, PATCH, και DELETE απαιτεί Idempotency-Key. Δοκιμάστε ξανά την ίδια λογική λειτουργία με το ίδιο κλειδί μετά από ένα χρονικό όριο. για 7 ημέρες Το Model Gate επιστρέφει το αρχικό αποτέλεσμα χωρίς να εκτελέσει ξανά τη μετάλλαξη. Η επαναχρησιμοποίηση ενός κλειδιού για διαφορετικό αίτημα επιστρέφει 409.

Πόσο καιρό είναι διαθέσιμο το λεπτομερές ιστορικό αιτημάτων;

Ακολουθεί αναλυτικό ιστορικό αιτημάτων συνεργάτη API_REQUESTS_HOT_RETENTION_DAYS (προεπιλογή 7 ημέρες) και αναφέρει αυτό το παράθυρο ως απόκριση μεταδεδομένων. Χρησιμοποιήστε συναλλαγές υπολοίπου λογαριασμού με σελιδοποίηση του δρομέα για μακροπρόθεσμη οικονομική συμφωνία.