Códigos de error de Webhooks
Todos los códigos de error de la API pública que emite Webhooks, con su estado HTTP, su type y una página por código.
Códigos de error que emite Webhooks. Cada code enlaza a su propia página con la causa y la acción a tomar.
| Code | Type | HTTP | Descripción |
|---|---|---|---|
addon_required | payment_required_error | 402 | Crear endpoints de webhook pertenece al add-on Developer API, y la empresa no lo tiene activo: el nivel gratuito permite cero endpoints. |
api_version_invalid_format | invalid_request_error | 422 | La versión de payload del endpoint no es una fecha YYYY-MM-DD. |
api_version_unsupported | invalid_request_error | 422 | La versión de payload está bien formada pero no está entre las que sirve la plataforma. |
custom_header_blocklisted | invalid_request_error | 422 | Una de las cabeceras personalizadas está reservada: la gestiona la capa HTTP (host, content-type, content-length, user-agent), la envía Factuarea como parte del contrato firmado (factuarea-*), o pertenece al proxy (x-forwarded-*). |
custom_header_value_too_long | invalid_request_error | 422 | El valor de una cabecera personalizada supera los 1024 caracteres. |
replay_delivery_not_retryable | invalid_request_error | 422 | Solo se reenvían las entregas fallidas. Una entrega que llegó bien, o una todavía en curso, no tiene nada que reenviar. |
replay_event_expired | invalid_request_error | 422 | El evento que respalda la entrega fue purgado por la política de retención de 30 días, así que ya no queda payload que reenviar. |
timeout_seconds_out_of_range | invalid_request_error | 422 | timeout_seconds queda fuera del rango de 1 a 30 segundos. |
too_many_custom_headers | invalid_request_error | 422 | El endpoint declara más de 20 cabeceras personalizadas. |
webhook_delivery_not_found | not_found_error | 404 | El identificador no corresponde a ningún intento de entrega, o la entrega queda fuera de la ventana de retención del histórico. |
webhook_endpoint_degraded | invalid_request_error | 422 | El endpoint está degradado tras fallos repetidos de entrega, así que los pings de prueba se rechazan mientras siga en ese estado. |
webhook_endpoint_not_found | not_found_error | 404 | El identificador no resuelve a ningún endpoint de webhook de la empresa autenticada. |
webhook_secret_recently_rotated | rate_limit_error | 429 | El secreto de firma se rotó hace menos de cinco minutos. La ventana de gracia permite que tu receptor acepte ambos secretos durante el cambio; rotar otra vez dentro de ella invalidaría firmas todavía en vuelo. |