Pontos de extremidade da API do parceiro

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

Autentique cada solicitação com Authorization: Bearer mg_partner_....

Chaves de 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

Principais campos de criação e atualização: name, group_id, rpm_limit, concurrency_limit, spend_limit. Um limite numérico de 0 significa ilimitado. group_id é o ID do grupo público ou um valor vazio para nenhum grupo.

Grupos-chave

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

Campos de criação e atualização de grupo: name, description, status, rpm_limit, concurrency_limit, spend_limit. O status é active ou frozen.

RPM de chave e grupo, simultaneidade e limites de gastos são aplicados de forma independente. Uma solicitação é rejeitada quando um dos níveis excede seu limite. Mover uma chave entre grupos não reescreve as estatísticas históricas: cada solicitação mantém o instantâneo do grupo capturado no momento da solicitação.

O uso de redefinição limpa o reconfigurável usage janela e atualizações usage_reset_at; isso nunca muda total_spent.

Transações e resultados assíncronos

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

As estatísticas de grupo usam tabelas agregadas para períodos concluídos e dados brutos. api_requests apenas para a hora incompleta atual.

Convenção de identificador: cada {id} nesta documentação está o recurso public_id. IDs de banco de dados numéricos internos nunca são aceitos ou retornados. Em rotas de membros aninhados, {keyId} é a chave da API public_id.