API krajnje točke partnera

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

Autentificirajte svaki zahtjev pomoću Authorization: Bearer mg_partner_....

API ključevi

• 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

Ključna polja za kreiranje i ažuriranje: name, group_id, rpm_limit, concurrency_limit, spend_limit. Brojčano ograničenje od 0 znači neograničeno. group_id je ID javne grupe ili prazna vrijednost za nijednu grupu.

Ključne skupine

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

Polja za stvaranje i ažuriranje grupe: name, description, status, rpm_limit, concurrency_limit, spend_limit. Status je active ili frozen.

RPM ključa i grupe, konkurentnost i ograničenja potrošnje provode se neovisno. Zahtjev se odbija kada bilo koja razina premaši svoje ograničenje. Premještanje ključa između grupa ne prepisuje povijesnu statistiku: svaki zahtjev zadržava snimku grupe snimljenu u trenutku zahtjeva.

Ponovno postavljanje briše mogućnost resetiranja usage prozor i ažuriranja usage_reset_at; nikad se ne mijenja total_spent.

Transakcije i asinkroni rezultati

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

Grupna statistika koristi skupne tablice za završena razdoblja i neobrađene api_requests samo za tekući nepuni sat.

Konvencija identifikatora: svaki {id} u ovoj dokumentaciji je izvor public_id. ID-ovi internih numeričkih baza podataka nikad se ne prihvaćaju niti vraćaju. U ugniježđenim rutama članova, {keyId} je API ključ public_id.