Punkty końcowe interfejsu API partnera

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

Uwierzytelniaj każde żądanie za pomocą Authorization: Bearer mg_partner_....

Klucze 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

Kluczowe pola tworzenia i aktualizacji: name, group_id, rpm_limit, concurrency_limit, spend_limit. Limit liczbowy wynoszący 0 oznacza nieograniczone. group_id to publiczny identyfikator grupy lub pusta wartość w przypadku braku grupy.

Grupy kluczowe

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

Grupuj pola tworzenia i aktualizowania: name, description, status, rpm_limit, concurrency_limit, spend_limit. Stan jest active Lub frozen.

Limity RPM klucza i grupy, współbieżności i wydatków są egzekwowane niezależnie. Żądanie zostaje odrzucone, gdy którykolwiek z poziomów przekroczy swój limit. Przenoszenie klucza między grupami nie powoduje przepisania statystyk historycznych: każde żądanie przechowuje migawkę grupy przechwyconą w momencie żądania.

Użycie resetowania kasuje możliwość resetowania usage okno i aktualizacje usage_reset_at; to nigdy się nie zmienia total_spent.

Transakcje i wyniki asynchroniczne

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

Statystyki grupowe wykorzystują tabele zbiorcze dla okresów pełnych i surowych api_requests tylko dla bieżącej, niepełnej godziny.

Konwencja identyfikatora: każdy {id} w tej dokumentacji znajduje się zasób public_id. Wewnętrzne numeryczne identyfikatory baz danych nigdy nie są akceptowane ani zwracane. W zagnieżdżonych trasach członkowskich {keyId} jest kluczem API public_id.