Come posso risolvere i problemi relativi ai webhook? – Supporto Bitly

Effettuiamo molteplici tentativi per inviare un evento webhook se la consegna iniziale non riesce. Dopo il primo tentativo fallito, inviamo un'email a tutti gli amministratori del tuo account per avvisarli del problema. Effettuiamo cinque tentativi prima di rimuovere l'evento dalla coda.

Se ulteriori eventi webhook falliscono, disattiviamo il webhook e inviamo un'altra email agli amministratori del tuo account.

Per saperne di più su come affrontiamo gli errori dei webhook, vai alla pagina webhooks della nostra documentazione per sviluppatori e scorri fino a Errori Webhook.

Cosa causa gli errori dei webhook?

Un errore del webhook potrebbe essere causato da un problema con la tua app o il tuo server, oppure potrebbe essere dovuto al fatto che il webhook non è configurato correttamente in Bitly. Un amministratore del tuo account Bitly può confermare che la configurazione del webhook sia corretta.

Per controllare la configurazione del webhook:

Questa procedura utilizza le impostazioni del tuo account per verificare la configurazione del webhook. Puoi farlo anche tramite l'API di Bitly.

Accedi al tuo account Bitly.
Fai clic su Impostazioni nella barra laterale a sinistra.
In Impostazioni account, fai clic su Webhooks.
Fai clic sui tre puntini accanto al webhook che stai risolvendo e seleziona Edit.
Verifica che l'URL dell'endpoint sia corretto.
Se il tuo webhook richiede la conformità OAuth, verifica che anche le impostazioni dei tuoi provider OAuth siano corrette.

Se hai confermato la configurazione in Bitly e hai controllato la presenza di problemi con la tua app e il tuo server, invia una richiesta al nostro team di supporto affinché possiamo aiutarti a identificare e risolvere il problema.

Verifica il tuo webhook tramite l'API

Se hai accesso all'API di Bitly e sai come utilizzarla, testa il tuo webhook con il nostro strumento di test API. L'endpoint di verifica webhook invia un messaggio di evento webhook di prova all'URL dell'endpoint del tuo webhook. Questo ti aiuta a testare il tuo webhook senza richiedere un clic o la scansione di un codice QR.

Il modo più semplice per testare è tramite il tuo terminale/prompt dei comandi preferito, con lo strumento da riga di comando curl. Puoi anche utilizzare app come Postman, insieme alla nostra Collezione API Bitly per Postman. Queste istruzioni utilizzano curl per verificare il webhook.

Genera un token di accesso.
Se non hai già l'identificatore univoco globale (GUID) della tua organizzazione e il GUID del webhook, raccogli prima queste informazioni. Se li hai entrambi, passa al passaggio 3.

Per trovare il tuo OrgGUID, controlla l'URL della finestra del browser mentre sei nel menu delle impostazioni del webhook nel tuo account Bitly. In questo esempio, l'OrgGUID è :org_guid.
Per trovare il tuo webhook GUID, richiedi i dettagli del tuo webhook tramite l'API con una richiesta Get Webhooks. Nella richiesta curl qui sotto, sostituisci {TOKEN} con il tuo token di accesso del passaggio 1, e :org_guid con il tuo GUID del passaggio 2a. Trova il GUID del webhook nella risposta curl.
```
curl \
-H 'Authorization: Bearer {TOKEN}' \
-X GET \
https://api-ssl.bitly.com/v4/organizations/:org_guid/webhooks
```

Invia la richiesta curl a Verify Webhook. Nella richiesta curl qui sotto, sostituisci {TOKEN} con il tuo token di accesso del passaggio 1, e :webhook_guid con il GUID trovato nel passaggio 2b.
```
curl \
-H 'Authorization: Bearer {TOKEN}' \
-X POST \
https://api-ssl.bitly.com/v4/webhooks/:webhook_guid/verify
```
Questo evento di test dovrebbe aiutare a risolvere eventuali problemi relativi al tuo endpoint.

Articoli in questa sezione

Cosa causa gli errori dei webhook?

Verifica il tuo webhook tramite l'API