Puntos finales de API de socios

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

Autentica cada solicitud con Authorization: Bearer mg_partner_....

Claves 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

Campos clave de creación y actualización: name, group_id, rpm_limit, concurrency_limit, spend_limit. Un límite numérico de 0 significa ilimitado. group_id es el ID del grupo público o un valor vacío para ningún grupo.

Grupos clave

• 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 creación y actualización de grupos: name, description, status, rpm_limit, concurrency_limit, spend_limit. El estado es active o frozen.

Los límites de RPM, simultaneidad y gasto de claves y grupos se aplican de forma independiente. Una solicitud se rechaza cuando cualquiera de los niveles excede su límite. Mover una clave entre grupos no reescribe las estadísticas históricas: cada solicitud mantiene la instantánea del grupo capturada en el momento de la solicitud.

Restablecer uso borra lo reiniciable usage ventana y actualizaciones usage_reset_at; nunca cambia total_spent.

Transacciones y resultados asíncronos

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

Las estadísticas de grupo utilizan tablas agregadas para períodos completos y sin procesar. api_requests sólo para la hora incompleta actual.

Convención de identificador: cada {id} en esta documentación está el recurso public_id. Los ID de bases de datos numéricas internas nunca se aceptan ni se devuelven. En rutas de miembros anidados, {keyId} es la clave API public_id.