Koncové body Partner API

Základní URL: https://panel.model-gate.com/api/v1/partner

Ověřte každý požadavek pomocí Authorization: Bearer mg_partner_....

API klíče

• 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

Klíčová pole pro vytvoření a aktualizaci: name, group_id, rpm_limit, concurrency_limit, spend_limit. Číselný limit 0 znamená neomezený. group_id je ID veřejné skupiny nebo prázdná hodnota pro žádnou skupinu.

Klíčové skupiny

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

Pole pro vytvoření a aktualizaci skupiny: name, description, status, rpm_limit, concurrency_limit, spend_limit. Stav je active nebo frozen.

Limity RPM klíče a skupiny, souběžnosti a útraty jsou vynucovány nezávisle. Požadavek je odmítnut, když některá z úrovní překročí svůj limit. Přesunutí klíče mezi skupinami nepřepisuje historické statistiky: každý požadavek uchovává snímek skupiny zachycený v době požadavku.

Obnovit použití vymaže resetovatelný obsah usage okno a aktualizace usage_reset_at; nikdy se to nemění total_spent.

Transakce a asynchronní výsledky

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

Skupinové statistiky používají souhrnné tabulky pro dokončená období a nezpracované api_requests pouze za aktuální neúplnou hodinu.

Konvence identifikátorů: každý {id} v této dokumentaci je zdroj public_id. ID interní číselné databáze se nikdy nepřijímají ani nevracejí. Ve vnořených trasách členů {keyId} je klíč API public_id.