Partner API-végpontok

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

Minden kérést hitelesítsen Authorization: Bearer mg_partner_....

API kulcsok

• 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

Kulcs létrehozási és frissítési mezői: name, group_id, rpm_limit, concurrency_limit, spend_limit. A numerikus korlát 0 korlátlanságot jelent. group_id a nyilvános csoportazonosító vagy üres érték a csoport nélkül.

Kulcscsoportok

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

Csoport létrehozási és frissítési mezők: name, description, status, rpm_limit, concurrency_limit, spend_limit. Az állapot az active vagy frozen.

A kulcs- és csoport-RPM, a párhuzamossági és a költési korlátok egymástól függetlenül érvényesülnek. A kérés elutasításra kerül, ha valamelyik szint meghaladja a korlátot. A kulcsok csoportok közötti mozgatása nem írja át az előzménystatisztikát: minden kérés megtartja a csoport pillanatfelvételét a kérés időpontjában.

A Reset usage törli a visszaállíthatót usage ablak és frissítések usage_reset_at; soha nem változik total_spent.

Tranzakciók és aszinkron eredmények

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

A csoportstatisztika összesített táblázatokat használ a befejezett és nyers időszakokra vonatkozóan api_requests csak az aktuális nem teljes órára.

Azonosító konvenció: minden {id} ebben a dokumentációban az erőforrás public_id. A belső numerikus adatbázis-azonosítók soha nem kerülnek elfogadásra vagy visszaadásra. A beágyazott tagútvonalakban {keyId} az API kulcs public_id.