Partner API

Το Partner API προορίζεται για τράπεζες, bots, πίνακες μεταπωλητών, εσωτερικά συστήματα παροχής και άλλες αξιόπιστες ενσωματώσεις διακομιστή σε διακομιστή. Η έκδοση 10.5.0 είναι το πρώτο συμβόλαιο μηχανήματος έτοιμου για Τράπεζα.

Βασική διεύθυνση URL

https://p-api.model-gate.com

Πιστοποίηση

Authorization: Bearer mg_partner_...

Κάθε απάντηση είναι JSON, συμπεριλαμβανομένων 404, 405, 429, και 500και περιλαμβάνει X-Request-ID. Απαντήσεις χρήση Cache-Control: no-store; ο κεντρικός υπολογιστής Partner δεν χρησιμοποιεί περιόδους σύνδεσης PHP του προγράμματος περιήγησης. Όλες οι εξωτερικές χρονικές σημάνσεις είναι UTC RFC3339 (YYYY-MM-DDTHH:MM:SSZ).

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

Τα αιτήματα συνεργατών προστατεύονται από ένα όριο χρέωσης ανά λεπτό σε επίπεδο λογαριασμού που έχει διαμορφωθεί από PARTNER_API_RATE_LIMIT_PER_MINUTE (αθέτηση 600). Οι απαντήσεις περιλαμβάνουν X-RateLimit-Limit, X-RateLimit-Remaining, και X-RateLimit-Reset; HTTP 429 περιλαμβάνει επίσης Retry-After.

Δημιουργήστε ή αναδημιουργήστε το κλειδί Partner API στο προφίλ Πύλης Μοντέλων. Το πλήρες διακριτικό φορέα εμφανίζεται μόνο μία φορά κατά τη δημιουργία/περιστροφή και το Model Gate αποθηκεύει μόνο τον κατακερματισμό SHA-256 συν ένα πρόθεμα εμφάνισης. Αποθηκεύστε το διακριτικό αμέσως στον διαχειριστή μυστικών από την πλευρά του διακομιστή σας. αν χαθεί, περιστρέψτε το.

Το προφίλ έχει ξεχωριστό Λίστα επιτρεπόμενων IP API. Όταν δεν είναι κενό, τα αιτήματα Partner API πρέπει να προέρχονται από μια επιτρεπόμενη ακριβή διεύθυνση IPv4/IPv6 ή πρόθεμα CIDR. Οι κανόνες API επιχειρηματικών οργανισμών ισχύουν εκτός από τον προσωπικό κανόνα. Μια πηγή που απορρίπτεται από οποιαδήποτε από τις ενεργές λίστες επιτρεπόμενων λαμβάνει HTTP 403 με error.type = ip_not_allowed.

Για επαγγελματικούς λογαριασμούς, το διαπιστευτήριο Partner API είναι διαθέσιμο μόνο στον επαληθευμένο κάτοχο του οργανισμού. Η διαχείριση των εντολέων υπαλλήλων και της εκχώρησης διαπιστευτηρίων επιχείρησης γίνεται στον πίνακα web, όπου μπορούν να επικυρωθούν τα δικαιώματα εκτέλεσης ομάδας. Επομένως, τα επιχειρηματικά κλειδιά που δημιουργούνται από συνεργάτες χρησιμοποιούν τον κάτοχο και ως κάτοχο χρέωσης και ως κύριο υπόχρεο διαπιστευτηρίων. Ένα παρεχόμενο group_id πρέπει να ονομάσει μια ενεργή ομάδα που ανήκει στον λογαριασμό· μια άγνωστη/παγωμένη ομάδα απορρίπτεται με HTTP 422 αντί να δημιουργήσετε σιωπηλά ένα μη ομαδοποιημένο κλειδί.

Δεκαδικές τιμές

Τα οικονομικά πεδία και τα πεδία χρήσης είναι πάντα συμβολοσειρές JSON:

{
  "spend_limit": "100.0000000000",
  "usage": "12.3456789000",
  "remaining": "87.6543211000",
  "usage_price_multiplier": "0.900000"
}

Χρησιμοποιήστε δεκαδική αριθμητική αυθαίρετης ακρίβειας. Μην μετατρέπετε ποτέ αυτές τις τιμές σε float.

Δυνατότητες

• Δημιουργία, λίστα, ενημέρωση, περιστροφή, πάγωμα, κατάργηση παγώματος και διαγραφή κλειδιών API.
• Διαμόρφωση εκτίμησης χρήσης ανά κλειδί.
• Δημιουργία και διαχείριση ομάδων.
• Μετακινήστε τα πλήκτρα μεταξύ των ομάδων.
• Διαβάστε τη χρήση κλειδιού και ομάδας.
• Διαβάστε το τελικό ιστορικό αιτημάτων για ένα κλειδί σε σειρά χρόνου λήξης με 1–100 σελίδες σειρών και ανάλυση διακριτικού/τιμής. Το λεπτομερές ιστορικό αιτημάτων διατηρείται εντατικά για API_REQUESTS_HOT_RETENTION_DAYS (προεπιλογή 7 ημέρες) Η πιο μακροπρόθεσμη χρηματοοικονομική συμφωνία χρησιμοποιεί το ημερολόγιο συναλλαγών υπολοίπου.
• Διαβάστε τις συναλλαγές του τρεχούμενου λογαριασμού και του υπολοίπου λογαριασμού με τη σελιδοποίηση του δρομέα.
• Διαβάστε συμβάντα ελέγχου διαχείρισης συνεργατών με σελιδοποίηση δρομέα.
• Δημοσκόπηση ασύγχρονων αποτελεσμάτων συμπερασμάτων.

Βλέπω όλα τα Partner API τελικά σημεία για πλήρη παραδείγματα αιτημάτων και απαντήσεων.

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

Μηχανικά αναγνώσιμο συμβόλαιο

Το συμβόλαιο OpenAPI 3.1 αποστέλλεται με κάθε έκδοση ως resources/contracts/partner-api.openapi.yaml. Αντιμετωπίστε το μαζί με αυτές τις Partner API σελίδες ως το συμβόλαιο ενοποίησης της Τράπεζας. Τα άγνωστα πεδία JSON και οι άγνωστες παράμετροι ερωτήματος απορρίπτονται αντί να αγνοούνται σιωπηλά.