Points de terminaison de l'API partenaire

URL de base : https://panel.model-gate.com/api/v1/partner

Authentifiez chaque demande avec Authorization: Bearer mg_partner_....

Clés 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

Champs clés de création et de mise à jour : name, group_id, rpm_limit, concurrency_limit, spend_limit. Une limite numérique de 0 signifie illimité. group_id est l'ID du groupe public ou une valeur vide pour aucun groupe.

Groupes clés

• 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}

Champs de création et de mise à jour de groupe : name, description, status, rpm_limit, concurrency_limit, spend_limit. Le statut est active ou frozen.

Les RPM des clés et des groupes, la simultanéité et les limites de dépenses sont appliqués indépendamment. Une demande est rejetée lorsque l'un ou l'autre des niveaux dépasse sa limite. Le déplacement d'une clé entre des groupes ne réécrit pas les statistiques historiques : chaque requête conserve l'instantané du groupe capturé au moment de la requête.

L'utilisation de la réinitialisation efface le réinitialisable usage fenêtre et mises à jour usage_reset_at; ça ne change jamais total_spent.

Transactions et résultats asynchrones

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

Les statistiques de groupe utilisent des tableaux agrégés pour les périodes terminées et brutes api_requests uniquement pour l'heure incomplète en cours.

Convention d'identification : chaque {id} dans cette documentation se trouve la ressource public_id. Les identifiants de base de données numériques internes ne sont jamais acceptés ou renvoyés. Dans les routes membres imbriquées, {keyId} est la clé API public_id.