Partner API-endepunkter

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

Autentiser hver forespørsel med Authorization: Bearer mg_partner_....

API-nøkler

• 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

Nøkkelopprettings- og oppdateringsfelt: name, group_id, rpm_limit, concurrency_limit, spend_limit. En numerisk grense på 0 betyr ubegrenset. group_id er den offentlige gruppe-ID-en eller en tom verdi for ingen gruppe.

Nøkkelgrupper

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

Gruppeopprettings- og oppdateringsfelt: name, description, status, rpm_limit, concurrency_limit, spend_limit. Status er active eller frozen.

Nøkkel- og gruppe-RPM, samtidighets- og forbruksgrenser håndheves uavhengig av hverandre. En forespørsel avvises når et av nivåene overskrider grensen. Å flytte en nøkkel mellom grupper omskriver ikke historisk statistikk: hver forespørsel holder gruppens øyeblikksbilde tatt på forespørselstidspunktet.

Tilbakestill bruk sletter den tilbakestillbare usage vindu og oppdateringer usage_reset_at; det endres aldri total_spent.

Transaksjoner og asynkroniseringsresultater

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

Gruppestatistikk bruker aggregerte tabeller for fullførte perioder og rå api_requests bare for den gjeldende ufullstendige timen.

Identifikatorkonvensjon: hver {id} i denne dokumentasjonen er ressursen public_id. Interne numeriske database-ID-er aksepteres eller returneres aldri. I nestede medlemsruter, {keyId} er API-nøkkelen public_id.