Skip to Content
API pública (próximamente)Errores y límites (próximamente)

Errores y límites Próximamente

Formato de los errores

Los errores siguen el estándar RFC 9457 (application/problem+json):

{ "type": "urn:nexunia:api:error:422", "title": "Error", "status": 422, "detail": "Esta Idempotency-Key ya se usó con una petición distinta.", "instance": "/v1/contacts", "request_id": "…" }

Los errores de validación incluyen además errors, con el campo y el motivo. Guarda el request_id si necesitas contactar con soporte.

CódigoSignifica
400Petición o cabecera Idempotency-Key no válidas
401Clave ausente, no válida, revocada o caducada
403Sin el permiso necesario, IP no autorizada o el plan no incluye la API
404No existe, o no pertenece a tu negocio
409Conflicto (p. ej. horario ocupado) o petición idéntica todavía en curso
422La Idempotency-Key ya se usó con una petición distinta
429Demasiadas peticiones

Límites de uso

  • 600 peticiones por minuto por clave (como máximo 120 de ellas, escrituras) y 1 800 por minuto entre todas las claves de tu negocio.
  • Cada respuesta lleva RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset (segundos hasta que se renueva la ventana).
  • Al superarlos recibes 429 con Retry-After: espera esos segundos.
  • Si una IP envía muchas peticiones con una clave inválida, se bloquea temporalmente.
Last updated on