Τελικά σημεία API συνεργατών

Βασική διεύθυνση URL: https://panel.model-gate.com/api/v1/partner

Έλεγχος ταυτότητας κάθε αιτήματος με Authorization: Bearer mg_partner_....

Κλειδιά API

• POST /keys
• GET /keys
• GET /keys/{id}
• PATCH /keys/{id}
• DELETE /keys/{id}
• POST /keys/{id}/freeze
• POST /keys/{id}/unfreeze
• POST /keys/{id}/rotate
• POST /keys/{id}/reset-usage
• GET /keys/{id}/usage
• GET /keys/{id}/spent-limit

Βασικά πεδία δημιουργίας και ενημέρωσης: name, group_id, rpm_limit, concurrency_limit, spend_limit. Ένα αριθμητικό όριο του 0 σημαίνει απεριόριστο. group_id είναι το δημόσιο αναγνωριστικό ομάδας ή μια κενή τιμή για καμία ομάδα.

Ομάδες κλειδιά

• GET /groups
• POST /groups
• GET /groups/{id}
• PATCH /groups/{id}
• DELETE /groups/{id}
• POST /groups/{id}/reset-usage
• GET /groups/{id}/usage
• GET /groups/{id}/stats
• GET /groups/{id}/members
• POST /groups/{id}/members
• DELETE /groups/{id}/members/{keyId}

Πεδία δημιουργίας και ενημέρωσης ομάδας: name, description, status, rpm_limit, concurrency_limit, spend_limit. Κατάσταση είναι active ή frozen.

Τα όρια RPM κλειδιού και ομάδας, συγχρονισμού και δαπανών επιβάλλονται ανεξάρτητα. Ένα αίτημα απορρίπτεται όταν οποιοδήποτε επίπεδο υπερβαίνει το όριό του. Η μετακίνηση ενός κλειδιού μεταξύ ομάδων δεν επαναγράφει τα ιστορικά στατιστικά στοιχεία: κάθε αίτημα διατηρεί το στιγμιότυπο της ομάδας καταγεγραμμένο τη στιγμή του αιτήματος.

Η επαναφορά χρήσης διαγράφει το μηδενιζόμενο usage παράθυρο και ενημερώσεις usage_reset_at; δεν αλλάζει ποτέ total_spent.

Συναλλαγές και ασύγχρονα αποτελέσματα

• GET /transactions
• GET /requests/{request_id}

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

Σύμβαση αναγνωριστικού: κάθε {id} σε αυτήν την τεκμηρίωση είναι ο πόρος public_id. Τα αναγνωριστικά εσωτερικών αριθμητικών βάσεων δεδομένων δεν γίνονται ποτέ αποδεκτά ούτε επιστρέφονται. Σε ένθετες διαδρομές μελών, {keyId} είναι το κλειδί API public_id.