Uso
Supervise la cuota de suscripción, el pack puntual y los créditos en tiempo real.
El endpoint de Uso devuelve la cuota API restante, los créditos, los límites de velocidad y los detalles de la clave API en cualquier momento. No consume créditos.
Nota: el objeto subscription refleja la cuota API combinada (suscripción + packs puntuales restantes), no solo la parte de suscripción. El panel de control muestra el desglose Suscripción / Packs puntuales.
Este endpoint es gratuito. Nunca consume créditos.
Solicitud
curl "https://api.chartquery.com/v1/usage" \
-H "x-api-key: YOUR_API_KEY"Los tres saldos
Cada llamada consume de hasta tres saldos, siempre en este orden. La respuesta detalla cada uno por separado para que sepa de dónde salen sus créditos.
- Cuota de suscripción (
subscription): llamadas incluidas en un plan mensual. Se reinicia en cada periodo de facturación (period,renewal_date). - Pack puntual (
packs): packs API puntuales, nunca se reinician, se consumen en orden de compra después de la cuota de suscripción.packs.currentes el pack en uso ahora. - Créditos de pago por uso (
credits): se usan solo cuando cuota y packs están agotados. Se facturan aparte.
remaining es el total aún disponible en los tres saldos y total_used el total consumido. Cuando remaining llega a 0, las llamadas devuelven 402 hasta que se añada un pack o créditos.
Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
remaining | integer | Total de créditos disponibles (cuota de suscripción + pack puntual + créditos) |
total_used | integer | Total de créditos consumidos hasta ahora (cuota API + extra; el uso de packs puntuales persiste entre períodos) |
renewal_date | string | Fecha de renovación de la suscripción (ISO 8601) |
period.start | string | Inicio del período de facturación actual |
period.end | string | Fin del período de facturación actual |
subscription.used | integer | Llamadas API usadas contra la cuota API combinada |
subscription.total | integer | Límite de cuota API combinada (suscripción + packs puntuales) |
subscription.remaining | integer | Cuota API combinada restante (parte de suscripción + packs puntuales sin usar) |
subscription.percent_used | number | Porcentaje de cuota API consumida |
credits.given | integer | Créditos extra concedidos (saldo separado) |
credits.consumed | integer | Créditos extra consumidos |
credits.remaining | integer | Créditos extra restantes |
rate_limit.per_minute | integer | null | Límite de solicitudes por minuto (null = ilimitado) |
rate_limit.per_second | integer | null | Límite de solicitudes por segundo (null = ilimitado) |
account.name | string | Nombre de la cuenta |
account.slug | string | Identificador de la cuenta |
api_key.alias | string | Nombre descriptivo de la clave API |
api_key.active | boolean | Si la clave está actualmente activa |
api_key.category | string | Categoría de la clave (p. ej. development, production) |
api_key.expires | string | null | Fecha de expiración de la clave (null = nunca expira) |
api_key.quotas | object | Cuotas personalizadas por clave: total, daily, weekly, monthly |
packs | object | null | Packs API puntuales, pack por pack (null si la cuenta no tiene ninguno). En cuentas sin plan mensual, subscription.total es la suma de todos los packs |
packs.count | integer | Número de packs activos |
packs.exhausted_count | integer | Número de packs totalmente consumidos |
packs.total | integer | Créditos otorgados por todos los packs activos |
packs.used | integer | Créditos consumidos en todos los packs |
packs.remaining | integer | Créditos restantes en todos los packs |
packs.current | object | null | El pack que se está consumiendo (los packs se usan en orden de compra); null cuando todos están agotados |
packs.items[] | object[] | Cada pack activo: id, title, purchased_at, total, used, remaining, percent_used, exhausted |
Ejemplo de respuesta
{
"remaining": 450,
"total_used": 1550,
"renewal_date": "2026-04-25",
"period": {
"start": "2026-03-25",
"end": "2026-04-25"
},
"subscription": {
"used": 1550,
"total": 2000,
"remaining": 450,
"percent_used": 77
},
"packs": {
"count": 2,
"exhausted_count": 1,
"all_exhausted": false,
"total": 25000000,
"used": 15200000,
"remaining": 9800000,
"percent_used": 60.8,
"current_index": 2,
"current": {
"id": "cm…",
"title": "Ultimate",
"purchased_at": "2026-02-07",
"total": 12500000,
"used": 2700000,
"remaining": 9800000,
"percent_used": 21.6,
"exhausted": false
},
"items": [
{ "id": "cm…", "title": "Ultimate", "purchased_at": "2025-11-10", "total": 12500000, "used": 12500000, "remaining": 0, "percent_used": 100, "exhausted": true },
{ "id": "cm…", "title": "Ultimate", "purchased_at": "2026-02-07", "total": 12500000, "used": 2700000, "remaining": 9800000, "percent_used": 21.6, "exhausted": false }
]
},
"credits": {
"given": 0,
"consumed": 0,
"remaining": 0,
"percent_used": 0
},
"rate_limit": {
"per_minute": null,
"per_second": null
},
"account": {
"name": "Acme Corp",
"slug": "acme-corp"
},
"api_key": {
"alias": "production",
"active": true,
"category": "production",
"expires": null,
"quotas": {
"total": null,
"daily": null,
"weekly": null,
"monthly": null
}
}
}Véase también: Stats para la salud de infraestructura de la plataforma en la última hora. No es el uso de su cuenta.