Referencia de métodos de la API de revendedores
Todos los endpoints de la API de revendedores en una tabla, con scope e idempotencia, y la especificación OpenAPI 3.1 de OneProvider lista para importar.
Todos los endpoints de la API de revendedores en una sola tabla, con su permiso (scope) y su indicador de idempotencia, y un enlace a la especificación OpenAPI 3.1.
Todos los modelos, capacidades y precios Índice de la documentación para agentes de IA:https://oneprovider.dev/docs/llms.txt Base URL: https://app.oneprovider.dev/partner/v1. Especificación OpenAPI 3.1 legible por máquinas: https://app.oneprovider.dev/partner/v1/openapi.yaml (pública, no hace falta token).
La columna «Idempotency» marca los métodos que exigen el encabezado Idempotency-Key. En la columna «Scope», «any» significa cualquier token válido y «none», que no hace falta token.
| Método | Ruta | Scope | Idempotency | Para qué sirve |
|---|---|---|---|---|
GET | /me | any | - | Token, permisos (scopes), revendedor. |
GET | /balance | read | - | Saldo de revendedor, reservado, disponible, precio mayorista, proveedores de recarga. |
GET | /balance/transactions | read | - | Transacciones del saldo (cursor). |
POST | /balance/topups | billing | obligatorio | Crea un pago de recarga, devuelve pay_url. |
GET | /balance/topups/{order_id} | billing | - | Estado de tu propio pago. |
GET | /pricing | read | - | Precio mayorista, descuento, límites. |
GET | /models | read | - | Catálogo de modelos y estado en vivo. |
GET | /customers | read | - | Lista de clientes (?external_id=). |
GET | /customers/{id} | read | - | Un cliente. |
POST | /customers | keys | - | Crea un cliente. |
PATCH | /customers/{id} | keys | - | Edita nombre, nota, bloqueo (blocked). |
GET | /customers/{id}/usage | read | - | Consumo de un cliente en todas sus claves activas, por día y por modelo (?days=1..90). |
GET | /keys | read | - | Lista de claves (?status=, ?query=, ?customer_id=). |
GET | /keys/{id} | read | - | Una clave sin el secreto, con dashboard_url. |
GET | /keys/{id}/usage | read | - | Consumo diario y por modelo de una clave (?days=1..90, por defecto 30). |
POST | /keys | keys | obligatorio | Emite una clave; el secreto se devuelve una sola vez. |
POST | /keys/bulk | keys | obligatorio | Emite varias claves idénticas a la vez. |
PATCH | /keys/{id} | keys | - | Límite, vencimiento (expires_days/hours) o ampliación (extend_days/hours), nombre, etiqueta del cliente. |
DELETE | /keys/{id} | keys | - | Elimina una clave (200 o 202). |
POST | /keys/{id}/topup | keys | obligatorio | Suma un importe al límite de la clave. |
POST | /keys/{id}/rotate | keys | obligatorio | Rota una clave: secreto nuevo, el anterior deja de funcionar. |
POST | /keys/{id}/pause | keys | - | Pausa una clave. |
POST | /keys/{id}/resume | keys | - | Reanuda una clave. |
POST | /orders | keys | obligatorio | Un pedido pagado de un cliente: clave nueva o recarga. |
GET | /orders | read | - | Lista de pedidos (?external_order_id=). |
GET | /orders/{id} | read | - | Un pedido. |
GET | /plans | read | - | Tus planes. |
POST | /plans | plans | - | Crea un plan. |
PATCH | /plans/{id} | plans | - | Edita un plan. |
DELETE | /plans/{id} | plans | - | Elimina un plan. |
GET | /code-batches | codes | - | Lista de lotes de códigos. |
POST | /code-batches | codes | obligatorio | Crea un lote de códigos. |
GET | /code-batches/{id} | codes | - | Un lote. |
GET | /code-batches/{id}/codes | codes | - | Códigos de un lote (?status=). |
POST | /code-batches/{id}/revoke | codes | - | Revoca los códigos sin canjear. |
GET | /codes/{code} | codes | - | Estado de un código. |
POST | /codes/{code}/redeem | codes | obligatorio | Canjea un código por una clave. |
GET | /stats | read | - | Estadísticas diarias (?days=1..90). |
GET | /audit | read | - | Registro de acciones (filtros period, actor, action, q). |
GET | /bot | bot | - | El bot de la tienda y el bot de soporte (sin tokens). |
GET | /settings | read | - | Ajustes de la tienda: nombre, contacto, marca, prefijo de clave, mensaje al cliente. |
PATCH | /settings | keys | - | Edita los ajustes de la tienda (solo los campos enviados). |
GET | /payment-providers | bot | - | Métodos de pago del bot: CryptoBot, xRocket, Platega (sin tokens); Stars siempre está activo. |
GET | /webhooks | webhooks | - | Lista de webhooks. |
POST | /webhooks | webhooks | - | Crea un webhook; el secreto se muestra una sola vez. |
DELETE | /webhooks/{id} | webhooks | - | Elimina un webhook. |
POST | /webhooks/{id}/test | webhooks | - | Envía un evento de prueba. |
GET | /webhooks/{id}/deliveries | webhooks | - | Registro de entregas. |
GET | /openapi.yaml | none | - | Especificación OpenAPI 3.1 (pública). |
Las reglas comunes (paginación, errores, límites) se describen en Autorización y límites .
Última actualización: 2026-11-08 ¿Encontraste un error? @Oneproviderhelpbot