Controleer de levering van webhooks en los eventuele fouten op.

Lees het leveringslogboek van een Notiondesk webhook-eindpunt, begrijp herhaalpogingen en pauzes, hervat een gepauzeerd eindpunt en los mislukte leveringen op.

4 min lezen

Elk eindpunt houdt een logboek bij van de verzoeken die ernaartoe zijn verzonden. Gebruik dit logboek om te zien wat uw server heeft ontvangen, waarom een ​​verzoek is mislukt en wanneer het opnieuw zal worden geprobeerd.

Snelkoppeling: Ga naar Instellingen > Ontwikkelaars > Webhooks , open een eindpunt en scrol naar Recente leveringen . Klik op een rij om het antwoord en de aanvraagbody te bekijken.

Lees meer over recente leveringen.

  1. Ga naar Instellingen > Ontwikkelaars > Webhooks .
  1. Klik op het eindpunt.
  1. Scroll naar beneden naar recente leveringen .

De lijst toont de 100 meest recente leveringen van de afgelopen 14 dagen. Elke rij toont de gebeurtenis, het helpcentrum (of de werkruimte ) waar deze vandaan kwam, het resultaat en het tijdstip.

Icon Status Wat het betekent
Groen vinkje Afgeleverd Uw server heeft geantwoord met de statuscode 2xx
Oranje klok In behandeling Nog niet verzonden, of in afwachting van de volgende poging. Een mislukte poging toont het resultaat gevolgd door 'opnieuw proberen' , zoals 503, opnieuw proberen.
Rode Kruis Mislukt Elke poging mislukte. De rij toont het laatste resultaat.
Grijs min Geannuleerd Niet verzonden omdat het eindpunt was gepauzeerd of uitgeschakeld, of omdat het helpcentrum geen gebeurtenissen meer kon ontvangen vóór de volgende poging.

Een levering openen

Klik op een rij om deze te openen:

  • Leverings-ID : dezelfde waarde als de X-ND-Delivery-header, zodat u het verzoek in de logboeken van uw server kunt terugvinden.
  • Reactie : de statuscode of de reden van de fout, hoe lang uw server erover deed en hoeveel pogingen er zijn gedaan.
  • Verzoekbody : de exacte JSON die is verzonden. Klik op Kopiëren om deze te kopiëren.

De inhoud van reacties wordt niet opgeslagen. Voor gebeurtenissen die persoonsgegevens bevatten, zoals contactberichten, feedback, teamleden en verzoeken om deel te nemen, wordt de reactie verwijderd zodra de levering is voltooid.

Opnieuw proberen

Een levering mislukt wanneer uw server reageert met een andere statuscode dan 2xx, doorverwijst, niet binnen 5 seconden begint met reageren of in totaal meer dan 10 seconden nodig heeft. Notiondesk probeert het dan opnieuw:

Poging Wanneer
1 Meteen
2 1 minuut na de eerste poging
3 10 minuten na de tweede poging
4 1 uur na de derde poging
5 6 uur na de vierde poging

Na 5 mislukte pogingen wordt de levering gemarkeerd als Mislukt . Testgebeurtenissen en leveringen die gemarkeerd zijn als 'Ondertekening mislukt' worden niet opnieuw geprobeerd.

Wanneer er veel gebeurtenissen tegelijk plaatsvinden, bijvoorbeeld tijdens een grote synchronisatie, kan het voorkomen dat leveringen moeten wachten voordat ze worden verzonden: meestal een paar minuten, en tot een uur als uw server traag reageert. Ze blijven in de wachtstand staan ​​en worden niet verwijderd.

Wanneer een eindpunt gepauzeerd is

Notiondesk pauzeert een eindpunt wanneer 10 leveringen achter elkaar na alle pogingen zijn mislukt en de eerste van die mislukkingen minstens 24 uur geleden heeft plaatsgevonden. Testgebeurtenissen tellen niet mee.

Wanneer een eindpunt gepauzeerd is:

  • Het geeft de status 'Gepauzeerd' weer en stopt met het ontvangen van gebeurtenissen. Reeds geplande pogingen worden geannuleerd.
  • De eigenaar van de werkruimte en de beheerders ontvangen één e-mail met de melding "Webhook-eindpunt gepauzeerd", met daarin de naam van het eindpunt, de host en een link naar de webhook-instellingen.
  • Gebeurtenissen uit de pauzeperiode worden niet later verzonden.

Om het samen te vatten:

  1. Repareer je server. De redenen voor de storing onder ' Recente leveringen' geven aan wat er mis is gegaan.
  1. Klik op 'Testgebeurtenis verzenden' en controleer of deze als 'Geleverd' wordt weergegeven.
  1. Klik op Hervatten .

Het eindpunt begint weer nieuwe gebeurtenissen te ontvangen en de teller voor het aantal fouten begint opnieuw.

Als uw eindpunt nog steeds actief is, maar leveringen blijven mislukken, wordt op de eindpuntpagina ' Mislukt sinds' weergegeven, met de datum van de eerste mislukking, als waarschuwing voordat het wordt gepauzeerd.

Foutieve leveringen oplossen

Als de server heeft gereageerd, wordt de statuscode weergegeven. Anders wordt de reden vermeld.

Reden Wat je ziet Wat is er gebeurd Hoe los ik dit op?
Foutstatus De statuscode, zoals 500 of 401. Uw server heeft een foutmelding gegeven. Controleer de logboeken van uw server voor dat tijdstip. Zorg ervoor dat het eindpunt POST-verzoeken accepteert en dat uw handtekeningcontrole het juiste geheim gebruikt.
Doorverwijzing geweigerd Een omleidingscode, zoals 301 of 302. Uw server heeft het verzoek doorgestuurd. Voer de uiteindelijke URL in bij de eindpuntinstellingen.
Adres geblokkeerd Adres geblokkeerd Uw domein verwijst naar een privé- of intern adres. Laat het domein verwijzen naar een openbare server.
Verbinding mislukt Verbinding mislukt Notiondesk kon uw server niet bereiken Controleer of het domein correct wordt opgelost, of het TLS-certificaat geldig is en of poort 443 of 8443 open staat.
De tijd is verlopen. De tijd is verlopen. Je server reageerde niet binnen 5 seconden, of het duurde langer dan 10 seconden. Beantwoord eerst met 200 en voer daarna de rest van het werk op de achtergrond uit.
Ondertekening mislukt Ondertekening mislukt Notiondesk kon het verzoek niet ondertekenen Dit ligt aan onze kant en wordt niet opnieuw geprobeerd. Verstuur een testgebeurtenis en neem contact met ons op als het probleem zich opnieuw voordoet.

Een testgebeurtenis verzenden

Klik op 'Testgebeurtenis verzenden' op de eindpuntpagina om een ​​ping-gebeurtenis naar dat eindpunt te verzenden. Deze verschijnt bovenaan in de lijst met recente leveringen .

  • Een testgebeurtenis wordt eenmalig verzonden, zonder herhaalpogingen.
  • Je kunt het verzenden terwijl het eindpunt gepauzeerd is, om je oplossing te controleren voordat je verdergaat.
  • Elke werkruimte kan maximaal 20 testgebeurtenissen per uur verzenden. Als u er meer dan 20 verzendt, verschijnt de melding "Te veel testgebeurtenissen. Probeer het later opnieuw."

Veelgestelde vragen

Kan ik een mislukte levering opnieuw verzenden?

Nee. Open de levering en klik op 'Kopiëren' om de aanvraaginhoud te verkrijgen als u deze zelf wilt verwerken.

Waarom ontbreekt de inhoud van een leveringsverzoek?

Het evenement bevatte persoonsgegevens, daarom werd de inhoud ervan verwijderd toen de levering was voltooid.

Hoe lang worden leveringen bewaard?

14 dagen. Recente leveringen tonen de laatste 100.

Wordt een gepauzeerd eindpunt hervat na een succesvolle testgebeurtenis?

Nee. Het controleert alleen je server. Klik op Hervatten om weer gebeurtenissen te ontvangen.

Wat gebeurt er met in de wachtrij staande gebeurtenissen als ik een eindpunt verwijder?

Ze worden niet verzonden en het leveringslogboek van het eindpunt wordt daarmee ook verwijderd.

Gerelateerde artikelen

Was deze pagina nuttig?

Still need help? Ask us