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ó |
|---|---|---|---|
account_webhook_endpoint_limit_reached | invalid_request_error | 422 | El compte va arribar al nombre d'endpoints de webhook de compte que permet el seu tram en aquest entorn. El límit es compta per compte i per entorn (live o test) i inclou els endpoints desactivats: només s'allibera una plaça en esborrar un endpoint. |
addon_required | payment_required_error | 402 | Crear endpoints de webhook exigeix un pla que els inclogui: en els d'empresa, l'add-on Developer API de l'empresa; en els de compte, el pla del pagador del compte. Aquí falta aquesta contractació: 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. |
invalid_url_target | invalid_request_error | 422 | L'amfitrió de destí no és una adreça públicament accessible, així que no hi lliurem: es rebutgen els rangs privats (RFC 1918), loopback, link-local, CGNAT (100.64.0.0/10), ULA IPv6 (fc00::/7) i multicast. Malgrat el que diu el missatge, la restricció s'aplica a tots els entorns, no només en producció. |
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 | invalid_request_error | 422 | 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. Es respon com un 422 business_rule_violation amb error.subcode webhook_secret_recently_rotated; no és un límit de peticions i no consumeix cap cubell de rate limit. |
Relacionat
Codis d'error per categoria
Localitza un error per la categoria que l'emet.
Taula de referència completa
Tots els codis, estats HTTP, tipus i descripcions en una referència.
Model d'errors
Interpreta la resposta d'error i gestiona els errors per codi.