Partner API-endepunkter

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

Autentificer hver anmodning med Authorization: Bearer mg_partner_....

API nøgler

• 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øgle oprette og opdatere felter: name, group_id, rpm_limit, concurrency_limit, spend_limit. En numerisk grænse på 0 betyder ubegrænset. group_id er det offentlige gruppe-id eller en tom værdi for ingen gruppe.

Nøglegrupper

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

Grupper oprette og opdatere felter: name, description, status, rpm_limit, concurrency_limit, spend_limit. Status er active eller frozen.

Nøgle- og gruppe-RPM, samtidigheds- og forbrugsgrænser håndhæves uafhængigt. En anmodning afvises, når et af niveauerne overskrider grænsen. Flytning af en nøgle mellem grupper omskriver ikke historisk statistik: hver anmodning holder gruppens øjebliksbillede fanget på anmodningstidspunktet.

Nulstil brug sletter den nulstillelige usage vindue og opdateringer usage_reset_at; det ændrer sig aldrig total_spent.

Transaktioner og asynkroniserede resultater

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

Gruppestatistikker bruger aggregerede tabeller for afsluttede perioder og rå api_requests kun for den aktuelle ufuldstændige time.

Identifikatorkonvention: hver {id} i denne dokumentation er ressourcen public_id. Interne numeriske database-id'er accepteres eller returneres aldrig. I indlejrede medlemsruter, {keyId} er API-nøglen public_id.