Partner API-slutpunkter

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

Autentisera varje begäran med Authorization: Bearer mg_partner_....

API-nycklar

• 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

Nyckel skapa och uppdatera fält: name, group_id, rpm_limit, concurrency_limit, spend_limit. En numerisk gräns på 0 betyder obegränsad. group_id är det offentliga grupp-ID eller ett tomt värde för ingen grupp.

Nyckelgrupper

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

Skapa och uppdatera fält för grupp: name, description, status, rpm_limit, concurrency_limit, spend_limit. Status är active eller frozen.

Nyckel- och grupp-RPM, samtidighet och utgiftsgränser upprätthålls oberoende av varandra. En begäran avvisas när någon av nivåerna överskrider sin gräns. Att flytta en nyckel mellan grupper skriver inte om historisk statistik: varje förfrågan håller gruppens ögonblicksbild fångad vid begäran.

Återställ användning rensar den återställningsbara usage fönster och uppdateringar usage_reset_at; det förändras aldrig total_spent.

Transaktioner och asynkroniseringsresultat

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

Gruppstatistik använder aggregerade tabeller för avslutade perioder och rå api_requests endast för den aktuella ofullständiga timmen.

Identifieringskonvention: varje {id} i denna dokumentation är resursen public_id. Interna numeriska databas-ID:n accepteras eller returneras aldrig. I kapslade medlemsvägar, {keyId} är API-nyckeln public_id.