Saltar al contingut principal
GET
curl

​
Estat de la destinació

health_status resumeix com ha estat responent la destinació als lliuraments. Un intent fallit és aquell al qual la destinació ha respost amb HTTP 400 o superior, o al qual no ha respost en absolut (temps d’espera, connexió rebutjada o adreça bloquejada). Els reintents no s’afegeixen a failing_streak, i qualsevol intent satisfactori, inclosos un reintent o un reenviament, posa fi a la ratxa. health_status és independent de enabled. Les mètriques de lliurament i daily_points cobreixen els últims 30 dies (metrics_window_days). daily_points té sempre 30 entrades, una per dia UTC, de la més antiga a la més recent.

​
Relacionat

Autoritzacions

​
x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Resposta

Llista de destinacions del webhook (sense paginar, les més antigues primer).

​
uuid
string<uuid>

Identificador de destinació estable; utilitza'l com a {destination_uuid} per actualitzar o eliminar.

​
label
string

Nom fàcil de llegir que es mostra a la Console.

​
url
string<uri>

URL de destinació que rep sol·licituds POST amb el payload del webhook.

​
enabled
boolean

Quan és false, Didit omet silenciosament el lliurament a aquesta destinació.

​
webhook_version
enum<string>

Versió de l'esquema del payload enviat a aquesta destinació. v3 és el format actual/recomanat.

Opcions disponibles:
v1,
v2,
v3
​
subscribed_events
enum<string>[]

Filtre d'esdeveniments per a aquesta destinació del webhook. Didit només lliura webhooks el tipus d'esdeveniment dels quals coincideix exactament amb un d'aquests valors; no hi ha subscripció amb caràcters comodí. Quan s'envia, la llista ha de contenir almenys un esdeveniment vàlid (un [] explícit es rebutja amb 400); una destinació amb la llista buida (camp omès en crear-se) no rep res. En actualitzar, la llista es reemplaça completament, mai es fusiona.

Minimum array length: 1

Nom d'esdeveniment de webhook admès. Utilitza aquestes cadenes exactes a subscribed_events; els valors no admesos es rebutgen.

Opcions disponibles:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
Exemple:
​
subscribed_events_count
integer

Longitud a la memòria cau de subscribed_events, útil per a la renderització de la interfície d'usuari.

​
deliveries_count
integer

Intents de lliurament (inclosos els reintents) fets a aquesta destinació en els darrers 30 dies.

​
failed_deliveries_count
integer

Intents de lliurament en els darrers 30 dies en què la destinació va respondre amb HTTP 400 o superior, o no va respondre (temps d'espera esgotat, connexió rebutjada o adreça bloquejada).

​
average_response_time_ms
integer | null

Temps de resposta mitjà en mil·lisegons durant els darrers 30 dies, arrodonit a un enter. null quan no hi ha hagut cap lliurament en aquesta finestra.

​
error_rate_percentage
integer

round(failed_deliveries_count / deliveries_count * 100) durant els darrers 30 dies; 0 quan no hi ha lliuraments.

​
last_delivery_at
string<date-time> | null

Marca de temps de l'intent de lliurament més recent (satisfactori o fallit). null si mai no s'ha lliurat.

​
metrics_window_days
integer

Durada en dies de la finestra que cobreixen deliveries_count, failed_deliveries_count, average_response_time_ms, error_rate_percentage i daily_points. Sempre és 30.

​
health_status
enum<string>

Estat del lliurament. failing: 3 o més esdeveniments consecutius han fallat en el seu primer intent de lliurament des que la destinació va respondre satisfactòriament per darrera vegada (consulta failing_streak). degraded: no és failing, però un intent de lliurament ha fallat en les darreres 24 hores i cap intent posterior ha lliurat aquest esdeveniment; un reintent o reenviament que el lliuri neteja aquest estat. healthy: cap dels dos. Independent d'enabled. Un intent fallit és un que ha rebut una resposta HTTP 400 o superior, o que no ha rebut cap resposta.

Opcions disponibles:
healthy,
degraded,
failing
​
failing_streak
integer

Quants esdeveniments consecutius han fallat en el seu primer intent de lliurament des que la destinació va respondre satisfactòriament per última vegada, durant els darrers 30 dies. Els reintents no es comptabilitzen, i qualsevol intent satisfactori, inclòs un reintent o un reenviament, posa fi a la ratxa. 0 quan cap esdeveniment ha fallat des de l'últim èxit.

​
failing_since
string<date-time> | null

Quan es va fer el primer intent fallit de la failing_streak actual. null quan failing_streak és 0.

​
last_success_at
string<date-time> | null

Quan la destinació va respondre per darrera vegada a un lliurament amb un estat HTTP inferior a 400, en els darrers 30 dies. null si no ho ha fet en aquest interval.

​
environment
enum<string>

Entorn de l'aplicació propietària de la destinació.

Opcions disponibles:
live,
sandbox
​
daily_points
object[]

Una entrada per dia UTC dels darrers 30 dies, el més antic primer, inclosos els dies sense lliuraments. Compta cada intent, reintents inclosos.

​
secret_last4
string

Últims quatre caràcters del secret de signatura actual de la destinació, perquè puguis distingir els secrets. No són suficients per verificar una signatura.

​
created_by_email
string | null

Correu electrònic del membre de la Business Console que ha creat la destinació. null per a una destinació creada amb una clau d'API.

​
created_by_name
string | null

Nom del membre de la Business Console que ha creat la destinació. null per a una destinació creada amb una clau d'API.

​
created_at
string<date-time>
​
updated_at
string<date-time>
Darrera modificació el 7 de novembre del 2026