Codis d'error de Webhooks
Tots els codis d'error de l'API pública que emet Webhooks, amb el seu estat HTTP, el seu type i una pàgina per codi.
Codis d'error que emet Webhooks. Cada code enllaça a la seva pròpia pàgina amb la causa i l'acció a prendre.
| Code | Type | HTTP | Descripció |
|---|---|---|---|
addon_required | payment_required_error | 402 | Crear endpoints de webhook pertany a l'add-on Developer API, i l'empresa no el té actiu: el nivell gratuït permet zero endpoints. |
api_version_invalid_format | invalid_request_error | 422 | La versió de payload de l'endpoint no és una data YYYY-MM-DD. |
api_version_unsupported | invalid_request_error | 422 | La versió de payload està ben formada però no és entre les que serveix la plataforma. |
custom_header_blocklisted | invalid_request_error | 422 | Una de les capçaleres personalitzades està reservada: la gestiona la capa HTTP (host, content-type, content-length, user-agent), l'envia Factuarea com a part del contracte signat (factuarea-*), o pertany al proxy (x-forwarded-*). |
custom_header_value_too_long | invalid_request_error | 422 | El valor d'una capçalera personalitzada supera els 1024 caràcters. |
replay_delivery_not_retryable | invalid_request_error | 422 | Només es reenvien els lliuraments fallits. Un lliurament que va arribar bé, o un encara en curs, no té res a reenviar. |
replay_event_expired | invalid_request_error | 422 | L'esdeveniment que dona suport al lliurament va ser purgat per la política de retenció de 30 dies, així que ja no queda payload a reenviar. |
timeout_seconds_out_of_range | invalid_request_error | 422 | timeout_seconds queda fora del rang d'1 a 30 segons. |
too_many_custom_headers | invalid_request_error | 422 | L'endpoint declara més de 20 capçaleres personalitzades. |
webhook_delivery_not_found | not_found_error | 404 | L'identificador no correspon a cap intent de lliurament, o el lliurament queda fora de la finestra de retenció de l'històric. |
webhook_endpoint_degraded | invalid_request_error | 422 | L'endpoint està degradat després de fallades repetides de lliurament, així que els pings de prova es rebutgen mentre segueixi en aquest estat. |
webhook_endpoint_not_found | not_found_error | 404 | L'identificador no resol a cap endpoint de webhook de l'empresa autenticada. |
webhook_secret_recently_rotated | rate_limit_error | 429 | El secret de signatura es va rotar fa menys de cinc minuts. La finestra de gràcia permet que el teu receptor accepti tots dos secrets durant el canvi; rotar un altre cop dins d'ella invalidaria signatures encara en vol. |