Партньорски API крайни точки

Основен URL адрес: https://panel.model-gate.com/api/v1/partner

Удостоверявайте всяка заявка с Authorization: Bearer mg_partner_....

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

Ключови полета за създаване и актуализиране: name, group_id, rpm_limit, concurrency_limit, spend_limit. Числен лимит от 0 означава неограничен. group_id е идентификаторът на публичната група или празна стойност за липса на група.

Ключови групи

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

Полета за създаване и актуализиране на група: name, description, status, rpm_limit, concurrency_limit, spend_limit. Състоянието е active или frozen.

Ключови и групови RPM, едновременност и ограничения на разходите се прилагат независимо. Заявката се отхвърля, когато някое от нивата надхвърли своя лимит. Преместването на ключ между групите не пренаписва исторически статистики: всяка заявка запазва моментната снимка на групата, заснета по време на заявката.

Reset usage изчиства възможността за нулиране usage прозорец и актуализации usage_reset_at; никога не се променя total_spent.

Транзакции и асинхронни резултати

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

Груповата статистика използва обобщени таблици за завършени периоди и необработени api_requests само за текущия непълен час.

Конвенция за идентификатор: всеки {id} в тази документация е ресурсът public_id. Вътрешните цифрови идентификатори на бази данни никога не се приемат или връщат. Във вложени членски маршрути, {keyId} е API ключът public_id.