Mi Cuota

GET /api/adcenter/v1/me/quota/

Devuelve el estado actual de tu cuota de API para el período de facturación. Este endpoint es gratuito — llamarlo no cuenta contra tu cuota mensual.


Método	`GET`
URL	`https://app.vzla.io/api/adcenter/v1/me/quota/`
Autenticación	`Authorization: Bearer vzlaio_...`
Parámetros	Ninguno

Solicitud

curl --request GET \
  --url 'https://app.vzla.io/api/adcenter/v1/me/quota/' \
  --header 'Authorization: Bearer vzlaio_TU_TOKEN_AQUI'

Respuesta

La respuesta de cuota es un objeto plano — no hay envelope data/meta.

Campo	Tipo	Descripción
`subscription`	string	Nombre de tu plan actual, p. ej. `"Free"`
`monthly_limit`	integer	Límite mensual de solicitudes de tu plan
`current_usage`	integer	Solicitudes realizadas este mes calendario
`remaining`	integer	Solicitudes restantes antes de agotar la cuota
`usage_percentage`	number	`current_usage / monthly_limit × 100`
`status_level`	string	`"normal"`, `"warning"`, `"critical"` o `"exceeded"`
`is_active`	boolean	Si tu token está activo
`has_quota`	boolean	Si te quedan solicitudes disponibles
`reset_date`	string (fecha-hora ISO 8601)	Cuándo comenzó el período de facturación actual
`next_reset`	string (fecha-hora ISO 8601)	Cuándo se reinicia tu contador — siempre el 1° del mes siguiente

Respuesta de ejemplo

{
  "subscription": "Free",
  "monthly_limit": 1000,
  "current_usage": 27,
  "remaining": 973,
  "usage_percentage": 2.7,
  "status_level": "normal",
  "is_active": true,
  "has_quota": true,
  "reset_date": "2026-09-01T00:00:00Z",
  "next_reset": "2026-10-01T00:00:00Z"
}

Códigos de estado HTTP

Código	Significado
`200 OK`	Éxito.
`401 Unauthorized`	Token faltante o inválido.
`403 Forbidden`	El token fue emitido para otra API de vzla.io.
`405 Method Not Allowed`	Solo se admite GET.
`500 Internal Server Error`	Error del servidor. Reintenta tras una breve pausa.

401 — sin encabezado Authorization

{
  "error": {
    "code": "auth_missing",
    "message": "Authentication credentials were not provided"
  }
}

401 — token inválido

{
  "error": {
    "code": "auth_token_unknown",
    "message": "Invalid token format"
  }
}

Documentación completa en texto plano para herramientas de IA (llms.txt)