Puncte finale API partener

Adresa URL de bază: https://panel.model-gate.com/api/v1/partner

Autentificați fiecare cerere cu Authorization: Bearer mg_partner_....

Chei 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

Câmpuri de creare și actualizare cheie: name, group_id, rpm_limit, concurrency_limit, spend_limit. O limită numerică de 0 înseamnă nelimitat. group_id este ID-ul grupului public sau o valoare goală pentru niciun grup.

Grupuri cheie

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

Grupați crearea și actualizarea câmpurilor: name, description, status, rpm_limit, concurrency_limit, spend_limit. Starea este active sau frozen.

Limitele RPM pentru cheie și grup, concurența și cheltuielile sunt aplicate independent. O solicitare este respinsă atunci când oricare dintre niveluri își depășește limita. Mutarea unei chei între grupuri nu rescrie statisticile istorice: fiecare solicitare păstrează instantaneul grupului capturat la momentul solicitării.

Resetarea utilizării șterge resetarea usage fereastră și actualizări usage_reset_at; nu se schimba niciodata total_spent.

Tranzacții și rezultate asincrone

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

Statisticile de grup folosesc tabele agregate pentru perioadele finalizate și brute api_requests numai pentru ora incompletă curentă.

Convenția de identificare: fiecare {id} în această documentație se află resursa public_id. ID-urile numerice interne ale bazei de date nu sunt niciodată acceptate sau returnate. În rutele membre imbricate, {keyId} este cheia API public_id.