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ódigo | Significa |
|---|---|
400 | Petición o cabecera Idempotency-Key no válidas |
401 | Clave ausente, no válida, revocada o caducada |
403 | Sin el permiso necesario, IP no autorizada o el plan no incluye la API |
404 | No existe, o no pertenece a tu negocio |
409 | Conflicto (p. ej. horario ocupado) o petición idéntica todavía en curso |
422 | La Idempotency-Key ya se usó con una petición distinta |
429 | Demasiadas 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-RemainingyRateLimit-Reset(segundos hasta que se renueva la ventana). - Al superarlos recibes
429conRetry-After: espera esos segundos. - Si una IP envía muchas peticiones con una clave inválida, se bloquea temporalmente.
Last updated on