- Categorie
- API
- Richting
- Verzenden van events
- Formaat
- JSON ondertekend met HMAC-SHA256
- Endpoints
- Tot 25 per organisatie
- Herhaalpogingen
- Tot 6 pogingen, verspreid over meer dan een dag
- Instellen
- Een HTTPS-adres en een secret
- Abonnementen
- Enterprise-abonnement
- Uitgever
- Upsellr
01Wat webhooks doen
Het signaal dat uw tools in beweging zet.
- 01
Een event aan het einde van elke verwerking
Voltooid, mislukt of gestopt: aan het einde van elke verrijkings- of generatieverwerking verstuurt Upsellr het event met de details van de verwerking.
- 02
Ondertekend, zodat u het kunt controleren
Elke levering bevat een ID, een tijdstempel en een HMAC-SHA256-handtekening berekend met uw secret: uw tool controleert dat ze echt van Upsellr komt.
- 03
Opnieuw verstuurd tot ze aankomt
Zonder 2xx-antwoord binnen 10 seconden probeert Upsellr het opnieuw na 1 minuut, 5 minuten, 30 minuten, 4 uur en daarna 24 uur.
- 04
Een logboek van elke levering
Status, HTTP-code, aantal pogingen en inhoud: elke levering is 7 dagen in te zien, en een mislukte levering verstuurt u met één klik opnieuw.
- 05
Koppel uw tools aan elkaar
Publiceer, waarschuw een team of start een export zodra de pagina’s klaar zijn: de webhook geeft het signaal, uw tool doet de rest.
- 06
Houd de regie
Schakel een endpoint uit, wijzig het secret of verwijder het: de openstaande herhaalpogingen worden geannuleerd.
02Aan de slag
Binnen enkele minuten gekoppeld.
- 01
Open de organisatie-instellingen
Sectie API en webhooks, voorbehouden aan eigenaren en beheerders.
- 02
Voeg een endpoint toe
Een HTTPS-URL die bereikbaar is vanaf internet.
- 03
Kopieer het secret
Het wordt maar één keer getoond en dient om de handtekening van elke levering te controleren.
- 04
Controleer de handtekening
Bereken de HMAC-SHA256-handtekening van de tijdstempel en de inhoud opnieuw, en weiger een levering die te oud is.
- 05
Antwoord snel
Een 2xx-antwoord binnen 10 seconden, en handel de rest daarna aan uw kant af.
03Events
De verzonden events.
| Event | Verzonden | Zo nodig opnieuw verstuurd |
|---|---|---|
| Verwerking voltooid (workflow.run.completed) | Ja | Ja |
| Verwerking mislukt (workflow.run.failed) | Ja | Ja |
| Verwerking gestopt (workflow.run.stopped) | Ja | Ja |
Compatibiliteit en vereisten
- Het Enterprise-abonnement
- Een openbaar HTTPS-adres, op poort 443
- Een rol als eigenaar of beheerder
- Een 2xx-antwoord binnen 10 seconden
- Tip: ontdubbel op de event-ID
U houdt de regie
Betrouwbaar door ontwerp.
- Ondertekend met HMAC-SHA256, met een eigen secret per endpoint
- Minstens één keer afgeleverd: ontdubbel op de event-ID
- Tot 6 keer opnieuw verstuurd, verspreid over meer dan een dag
- Verzonden via HTTPS, uitsluitend naar openbare adressen
04Vragen
Vragen over Upsellr-webhooks.
Zitten webhooks in mijn abonnement?
Net als de API zijn ze voorbehouden aan het Enterprise-abonnement.
Welke events worden verzonden?
Het einde van een verrijkings- of generatieverwerking: voltooid, mislukt of gestopt. Elk event bevat de details van de verwerking.
Hoe controleer ik dat een levering van Upsellr komt?
Bereken met uw secret de HMAC-SHA256-handtekening van de tijdstempel en de inhoud opnieuw, vergelijk die met de header X-Upsellr-Signature, en weiger een levering die ouder is dan 5 minuten.
Wat gebeurt er als mijn server niet antwoordt?
Zonder 2xx-antwoord binnen 10 seconden probeert Upsellr het opnieuw na 1 minuut, 5 minuten, 30 minuten, 4 uur en daarna 24 uur. Een mislukte levering kunt u ook handmatig opnieuw versturen vanuit het logboek.
Kan ik hetzelfde event twee keer ontvangen?
Ja, dat kan: levering is minstens één keer gegarandeerd, zonder gegarandeerde volgorde. Ontdubbel op de event-ID.
Hoe lang wordt het logboek bewaard?
7 dagen, met de status, de HTTP-code, het aantal pogingen en de inhoud van elke levering.
Hoeveel endpoints kan ik registreren?
Tot 25 per organisatie, elk met een eigen secret dat u kunt vernieuwen.
Verstuurt een test in de workfloweditor een event?
Nee. Alleen echte verwerkingen versturen events.
Je volgende product
verdient meer dan knippen en plakken.
Geef je AI-team zijn eerste producten om mee aan de slag te gaan.
Marcus
Amazon