Mi Cuota
GET /api/quantis/v3/me/quota/
Devuelve el plan de tu cuenta, su uso en el mes calendario actual y su límite de velocidad. Llamarlo no cuenta contra tu cuota mensual, pero sí cuenta contra el límite de velocidad de tu plan.
El uso es por cuenta: todas las claves de tu cuenta suman al mismo contador, así que cualquiera de tus claves devuelve los mismos números.
| Método | GET |
| URL | https://app.vzla.io/api/quantis/v3/me/quota/ |
| Autenticación | Authorization: Bearer qapi_... |
| Parámetros | Ninguno |
Solicitud
curl --request GET \ --url 'https://app.vzla.io/api/quantis/v3/me/quota/' \ --header 'Authorization: Bearer qapi_TU_CLAVE_AQUI'Respuesta
La respuesta de cuota es un objeto plano. No tiene envelope data/meta.
| Campo | Tipo | Descripción |
|---|---|---|
tier | object | Tu plan actual: code (p. ej. "pro") y name (p. ej. "Pro") |
monthly_quota | integer o null | Solicitudes incluidas por mes calendario. null cuando tu plan no tiene cuota mensual |
used | integer | Solicitudes contadas este mes calendario, sumando todas tus claves |
remaining | integer o null | Solicitudes restantes este mes. null cuando tu plan no tiene cuota mensual |
usage_percentage | number o null | used / monthly_quota × 100. null cuando tu plan no tiene cuota mensual |
status_level | string | "normal" (menos de 70%), "warning" (70% o más), "critical" (90% o más) o "exceeded" (100% o más). Siempre "normal" cuando tu plan no tiene cuota mensual |
reset_at | string (datetime ISO 8601) | Cuándo se reinicia tu contador: el día 1 del próximo mes a las 00:00, hora de Caracas |
rate_limit | string | El límite de velocidad de tu plan como <solicitudes>/<período>, p. ej. "60/m" (s segundo, m minuto, h hora, d día) |
expires_at | string (datetime ISO 8601) o null | Cuándo termina tu período pagado actual. null cuando no vence |
Ejemplo de respuesta
{ "tier": {"code": "pro", "name": "Pro"}, "monthly_quota": 50000, "used": 1234, "remaining": 48766, "usage_percentage": 2.5, "status_level": "normal", "reset_at": "2026-11-01T00:00:00-04:00", "rate_limit": "60/m", "expires_at": null}Los valores de arriba son un ejemplo. Consulta center.quantis.vzla.io para ver los planes vigentes.
Códigos de estado HTTP
| Código | Significado |
|---|---|
200 OK | Éxito. |
401 Unauthorized | Clave ausente, inválida o revocada. |
405 Method Not Allowed | Solo se admite GET. |
429 Too Many Requests | Límite de velocidad alcanzado (throttled). Espera los segundos del encabezado Retry-After. Ver Planes y límites. |
500 Internal Server Error | Error del servidor. Reintenta después de un momento. |
401: sin encabezado Authorization
{ "error": { "code": "auth_missing", "message": "Authentication credentials were not provided" }}401: clave inválida
{ "error": { "code": "auth_token_unknown", "message": "Invalid token format" }}429: límite de velocidad alcanzado
{ "error": { "code": "throttled", "message": "Rate limit exceeded", "details": { "retry_after": 1 } }}