Vai al contenuto principale
GET
curl

​
Stato della destinazione

health_status riassume come la destinazione ha risposto alle consegne. Un tentativo fallito è quello in cui la destinazione ha risposto con HTTP 400 o superiore, oppure a cui non ha risposto affatto (timeout, connessione rifiutata o indirizzo bloccato). I nuovi tentativi non incrementano failing_streak, e qualsiasi tentativo riuscito, incluso un nuovo tentativo o un reinvio, interrompe la serie. health_status è indipendente da enabled. Le metriche di consegna e daily_points coprono gli ultimi 30 giorni (metrics_window_days). daily_points contiene sempre 30 voci, una per giorno UTC, dalla più vecchia alla più recente.

​
Correlati

Autorizzazioni

​
x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Risposta

Elenca le destinazioni webhook (senza paginazione, dalla meno recente alla più recente).

​
uuid
string<uuid>

Identificatore stabile della destinazione; da usare come {destination_uuid} per aggiornamento/eliminazione.

​
label
string

Nome di facile lettura mostrato nella Console.

​
url
string<uri>

URL di destinazione che riceve richieste POST con il payload del webhook.

​
enabled
boolean

Quando è false, Didit ignora silenziosamente la consegna a questa destinazione.

​
webhook_version
enum<string>

Versione dello schema del payload inviata a questa destinazione. v3 è il formato attuale/consigliato.

Opzioni disponibili:
v1,
v2,
v3
​
subscribed_events
enum<string>[]

Filtro degli eventi per questa destinazione webhook. Didit consegna solo i webhook il cui tipo di evento corrisponde esattamente a uno di questi valori — non esiste un abbonamento con caratteri jolly. Quando viene inviato, l'elenco deve contenere almeno un evento valido (un [] esplicito viene rifiutato con 400); una destinazione il cui elenco è vuoto (campo omesso alla creazione) non riceve nulla. In caso di aggiornamento, l'elenco viene sostituito per intero, mai unito.

Minimum array length: 1

Nome dell'evento webhook supportato. Usa queste stringhe esatte in subscribed_events; i valori non supportati vengono rifiutati.

Opzioni disponibili:
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
Esempio:
​
subscribed_events_count
integer

Lunghezza memorizzata nella cache di subscribed_events, utile per il rendering dell'interfaccia utente.

​
deliveries_count
integer

Tentativi di consegna (inclusi i nuovi tentativi) effettuati verso questa destinazione negli ultimi 30 giorni.

​
failed_deliveries_count
integer

Tentativi di consegna negli ultimi 30 giorni a cui la destinazione ha risposto con HTTP 400 o superiore, oppure non ha risposto (timeout, connessione rifiutata o indirizzo bloccato).

​
average_response_time_ms
integer | null

Tempo medio di risposta in millisecondi negli ultimi 30 giorni, arrotondato a un numero intero. null in assenza di consegne in tale intervallo.

​
error_rate_percentage
integer

round(failed_deliveries_count / deliveries_count * 100) negli ultimi 30 giorni; 0 quando non ci sono consegne.

​
last_delivery_at
string<date-time> | null

Timestamp del tentativo di consegna più recente (riuscito o fallito). null se non è mai stata consegnata.

​
metrics_window_days
integer

Durata in giorni dell'intervallo coperto da deliveries_count, failed_deliveries_count, average_response_time_ms, error_rate_percentage e daily_points. Sempre 30.

​
health_status
enum<string>

Stato della consegna. failing: 3 o più eventi consecutivi hanno fallito il primo tentativo di consegna dall'ultima risposta riuscita della destinazione (vedere failing_streak). degraded: non in errore, ma un tentativo di consegna è fallito nelle ultime 24 ore e nessun tentativo successivo ha consegnato quell'evento; un nuovo tentativo o reinvio che lo consegna cancella questa condizione. healthy: nessuno dei due. Indipendente da enabled. Un tentativo fallito è quello a cui è stato risposto con HTTP 400 o superiore, o a cui non è stata data alcuna risposta.

Opzioni disponibili:
healthy,
degraded,
failing
​
failing_streak
integer

Quanti eventi consecutivi hanno fallito il primo tentativo di consegna dall'ultima risposta positiva della destinazione, negli ultimi 30 giorni. I nuovi tentativi non vengono conteggiati e qualsiasi tentativo riuscito, inclusi nuovi tentativi o reinvii, interrompe la serie. 0 quando nessun evento ha fallito dall'ultimo successo.

​
failing_since
string<date-time> | null

Data e ora del primo tentativo fallito dell'attuale failing_streak. null quando failing_streak è 0.

​
last_success_at
string<date-time> | null

Data e ora dell'ultima risposta della destinazione a una consegna con uno stato HTTP inferiore a 400, negli ultimi 30 giorni. null se non ha risposto in tale intervallo.

​
environment
enum<string>

Ambiente dell'applicazione proprietaria della destinazione.

Opzioni disponibili:
live,
sandbox
​
daily_points
object[]

Una voce per ogni giorno UTC degli ultimi 30 giorni, a partire dal più vecchio, inclusi i giorni senza consegne. Conteggia ogni tentativo, nuovi tentativi inclusi.

​
secret_last4
string

Ultimi quattro caratteri del segreto di firma attuale della destinazione, per consentirti di distinguere i segreti. Non sufficienti per verificare una firma.

​
created_by_email
string | null

Email del membro della Business Console che ha creato la destinazione. null per una destinazione creata con una chiave API.

​
created_by_name
string | null

Nome del membro della Business Console che ha creato la destinazione. null per una destinazione creata con una chiave API.

​
created_at
string<date-time>
​
updated_at
string<date-time>
Ultima modifica il 7 novembre 2026