GEThttps://api.veriko.mx/v1/usage/limits

Consultar los límites de tasa (rate-limits)

Audiencia
public
Autenticación
API key
Permiso
usage:read_self
Guía de uso →

Devuelve los límites de tasa aplicables al usuario autenticado, por contexto.

Los contextos no llevan los mismos límites. api limita las peticiones autenticadas por clave y por minuto, con el valor del plan de la cuenta (key_per_minute), y suma un techo por IP (ip_ceiling_per_minute); las peticiones sin clave se limitan por IP (ip_per_minute). webhooks fija las entregas por minuto que la cuenta puede enviar hacia un mismo host destino, según su plan (host_per_minute), y el tope de todos los clientes juntos sobre ese host (host_global_per_minute). login limita por IP y por correo electrónico, cada uno por minuto y por hora.

No devuelve contadores en vivo, sólo la configuración vigente. Estos límites son ajenos a la cuota mensual de validaciones, que devuelve GET /v1/usage/summary. El consumo de la ventana en curso lo informan, en cada respuesta autenticada de la API, las cabeceras X-RateLimit-*.

Petición
curl -X GET 'https://api.veriko.mx/v1/usage/limits' \
  -H 'Authorization: Bearer veriko_••••'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

Respuesta 200GetUsageLimitsAttributes — Configuración estática de límites de tasa por contexto.
CampoTipoDescripción
dataobject

Cuerpo de la respuesta, en la envoltura JSON:API.

typestring

Tipo de recurso JSON:API. Siempre usage_limits.

p. ej. usage_limits
attributesobject

Datos de los límites: los límites por contexto y sus notas.

rate_limitsobject

Límites de tasa por contexto. Cada entrada trae sólo los que ese contexto aplica: api lleva key_per_minute, ip_ceiling_per_minute e ip_per_minute; webhooks, host_per_minute y host_global_per_minute; login, los cuatro de IP y correo electrónico. key_per_minute y host_per_minute los fija el plan de la cuenta.

notesarray

Notas legibles sobre los límites, resueltas al idioma de la petición.

Códigos de respuestaGET /v1/usage/limits
CódigoClaseDescripciónCuerpo
2002xxConfiguración estática de límites de tasa por contexto.GetUsageLimitsAttributes
4014xxSe requiere autenticación o las credenciales son inválidasErrorResponse
4034xxPermisos insuficientesErrorResponse
Errores de GET /v1/usage/limits
CódigoClaveEjemplo
401unauthorized

Credenciales de autenticación ausentes o inválidas.

Envelope
meta.request_id
c4d5e6f7a8b99b8a7f6e5d4c
403permission_denied

No tienes permiso para acceder a este recurso.

Envelope
meta.request_id
d5e6f7a8b9c00c9b8a7f6e5d