Partner API-eindpunten

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

Authenticeer elk verzoek met Authorization: Bearer mg_partner_....

API-sleutels

• 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

Sleutelvelden voor het maken en bijwerken: name, group_id, rpm_limit, concurrency_limit, spend_limit. Een numerieke limiet van 0 betekent onbeperkt. group_id is de openbare groeps-ID of een lege waarde voor geen groep.

Sleutelgroepen

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

Velden voor het maken en bijwerken van groepen: name, description, status, rpm_limit, concurrency_limit, spend_limit. Staat is active of frozen.

Sleutel- en groeps-RPM, gelijktijdigheid en bestedingslimieten worden onafhankelijk afgedwongen. Een verzoek wordt afgewezen wanneer een van beide niveaus de limiet overschrijdt. Het verplaatsen van een sleutel tussen groepen herschrijft de historische statistieken niet: bij elk verzoek wordt de momentopname van de groep bewaard die op het tijdstip van het verzoek is vastgelegd.

Gebruik resetten wist de resetbare waarde usage venster en updates usage_reset_at; het verandert nooit total_spent.

Transacties en asynchrone resultaten

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

Groepsstatistieken gebruiken aggregatietabellen voor voltooide perioden en onbewerkt api_requests alleen voor het huidige onvolledige uur.

Identificatieconventie: elke {id} in deze documentatie staat de bron public_id. Interne numerieke database-ID's worden nooit geaccepteerd of geretourneerd. In geneste ledenroutes, {keyId} is de API-sleutel public_id.