Endpoint API partner

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

Autentica ogni richiesta con Authorization: Bearer mg_partner_....

Chiavi 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

Campi chiave per la creazione e l'aggiornamento: name, group_id, rpm_limit, concurrency_limit, spend_limit. Un limite numerico di 0 significa illimitato. group_id è l'ID del gruppo pubblico o un valore vuoto per nessun gruppo.

Gruppi chiave

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

Campi di creazione e aggiornamento del gruppo: name, description, status, rpm_limit, concurrency_limit, spend_limit. Lo stato è active O frozen.

RPM di chiave e gruppo, concorrenza e limiti di spesa vengono applicati in modo indipendente. Una richiesta viene rifiutata quando uno dei livelli supera il limite. Lo spostamento di una chiave tra gruppi non riscrive le statistiche storiche: ogni richiesta mantiene lo snapshot del gruppo catturato al momento della richiesta.

Reimposta utilizzo cancella il ripristinabile usage finestra e aggiornamenti usage_reset_at; non cambia mai total_spent.

Transazioni e risultati asincroni

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

Le statistiche di gruppo utilizzano tabelle aggregate per periodi completati e non elaborate api_requests solo per l'ora incompleta corrente.

Convenzione identificatore: ogni {id} in questa documentazione è la risorsa public_id. Gli ID numerici interni del database non vengono mai accettati o restituiti. Nelle rotte dei membri nidificati, {keyId} è la chiave API public_id.