Конечные точки партнерского 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, ограничения параллелизма и расходов применяются независимо. Запрос отклоняется, когда любой из уровней превышает свой предел. Перемещение ключа между группами не перезаписывает историческую статистику: при каждом запросе сохраняется групповой снимок, сделанный во время запроса.

Использование сброса очищает сбрасываемый usage окно и обновления usage_reset_at; это никогда не меняется total_spent.

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

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

В групповой статистике используются агрегированные таблицы для завершенных периодов и необработанные данные. api_requests только за текущий неполный час.

Соглашение идентификатора: каждый {id} в этой документации есть ресурс public_id. Внутренние числовые идентификаторы базы данных никогда не принимаются и не возвращаются. Во вложенных маршрутах-членах {keyId} это ключ API public_id.