Punts finals de l'API del partner

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

Autentiqueu cada sol·licitud amb Authorization: Bearer mg_partner_....

Claus 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

Camps de creació i actualització de claus: name, group_id, rpm_limit, concurrency_limit, spend_limit. Un límit numèric de 0 significa il·limitat. group_id és l'identificador de grup públic o un valor buit per a cap grup.

Grups clau

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

Camps de creació i actualització de grups: name, description, status, rpm_limit, concurrency_limit, spend_limit. L'estat és active o frozen.

Els límits de RPM, concurrència i despesa de clau i grup s'apliquen de manera independent. Una sol·licitud es rebutja quan qualsevol dels nivells supera el seu límit. Moure una clau entre grups no reescriu les estadístiques històriques: cada sol·licitud manté la instantània del grup capturada en el moment de la sol·licitud.

Restablir l'ús esborra el reiniciable usage finestra i actualitzacions usage_reset_at; no canvia mai total_spent.

Transaccions i resultats asíncrons

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

Les estadístiques de grup utilitzen taules agregades per a períodes completats i en brut api_requests només per a l'hora incompleta actual.

Convenció d'identificador: cada {id} en aquesta documentació hi ha el recurs public_id. Els identificadors de bases de dades numèriques internes mai s'accepten ni es retornen. A les rutes de membres imbricades, {keyId} és la clau de l'API public_id.