- Kategori
- API
- Retning
- Afsendelse af hændelser
- Format
- JSON signeret med HMAC-SHA256
- Adresser
- Op til 25 pr. organisation
- Nye forsøg
- Op til 6 forsøg, over mere end et døgn
- Opsætning
- En HTTPS-adresse og en hemmelig nøgle
- Planer
- Enterprise-planen
- Udgiver
- Upsellr
01Det kan webhooks
Signalet, der får dine værktøjer videre.
- 01
En hændelse ved slutningen af hver kørsel
Fuldført, mislykket eller stoppet: når hver berigelse eller generering er slut, sender Upsellr hændelsen med kørslens detaljer.
- 02
Signeret, så den kan verificeres
Hver levering har et ID, et tidsstempel og en HMAC-SHA256-signatur beregnet med din hemmelige nøgle: dit værktøj kontrollerer, at den virkelig kommer fra Upsellr.
- 03
Sendes igen, indtil den modtages
Uden et 2xx-svar inden for 10 sekunder prøver Upsellr igen efter 1 minut, 5 minutter, 30 minutter, 4 timer og derefter 24 timer.
- 04
En log over hver levering
Status, HTTP-kode, antal forsøg og indhold: hver levering kan ses i 7 dage, og en mislykket levering sendes igen med ét klik.
- 05
Kæd dine værktøjer sammen
Udgiv, giv et team besked eller start en eksport, så snart siderne er klar: webhooken giver signalet, dit værktøj klarer resten.
- 06
Behold kontrollen
Deaktiver en adresse, skift dens hemmelige nøgle eller slet den: dens ventende nye forsøg annulleres.
02Kom i gang
Forbundet på få minutter.
- 01
Åbn organisationens indstillinger
Sektionen API og webhooks, forbeholdt ejere og administratorer.
- 02
Tilføj en adresse
En HTTPS-URL, der kan nås fra internettet.
- 03
Kopiér den hemmelige nøgle
Den vises kun én gang og bruges til at verificere signaturen på hver levering.
- 04
Verificer signaturen
Beregn HMAC-SHA256-signaturen af tidsstemplet og indholdet igen, og afvis en levering, der er for gammel.
- 05
Svar hurtigt
Et 2xx-svar på under 10 sekunder, og håndtér derefter resten hos dig selv.
03Hændelser
De hændelser, der sendes.
| Hændelse | Sendes | Sendes igen ved behov |
|---|---|---|
| Kørsel fuldført (workflow.run.completed) | Ja | Ja |
| Kørsel mislykket (workflow.run.failed) | Ja | Ja |
| Kørsel stoppet (workflow.run.stopped) | Ja | Ja |
Kompatibilitet og krav
- Enterprise-planen
- En offentlig HTTPS-adresse, på port 443
- En ejer- eller administratorrolle
- Et 2xx-svar på under 10 sekunder
- Tip: dedupliker på hændelses-ID’et
Du har kontrollen
Pålidelige fra bunden.
- Signeret med HMAC-SHA256, med en egen hemmelig nøgle pr. adresse
- Leveret mindst én gang: dedupliker på hændelses-ID’et
- Sendt igen op til 6 gange, over mere end et døgn
- Sendt via HTTPS, kun til offentlige adresser
04Spørgsmål
Spørgsmål om Upsellrs webhooks.
Er webhooks inkluderet i min plan?
De er forbeholdt Enterprise-planen, ligesom API’et.
Hvilke hændelser sendes?
Slutningen på en berigelse eller generering: fuldført, mislykket eller stoppet. Hver hændelse indeholder kørslens detaljer.
Hvordan kontrollerer jeg, at en levering kommer fra Upsellr?
Beregn HMAC-SHA256-signaturen af tidsstemplet og indholdet igen med din hemmelige nøgle, sammenlign den med headeren X-Upsellr-Signature, og afvis leveringer, der er ældre end 5 minutter.
Hvad sker der, hvis min server ikke svarer?
Uden et 2xx-svar inden for 10 sekunder prøver Upsellr igen efter 1 minut, 5 minutter, 30 minutter, 4 timer og derefter 24 timer. En mislykket levering kan også sendes igen manuelt fra loggen.
Kan jeg modtage den samme hændelse to gange?
Ja, det kan ske: levering er garanteret mindst én gang, uden garanteret rækkefølge. Dedupliker på hændelses-ID’et.
Hvor længe gemmes loggen?
7 dage, med status, HTTP-kode, antal forsøg og indhold for hver levering.
Hvor mange adresser kan jeg tilføje?
Op til 25 pr. organisation, hver med sin egen hemmelige nøgle, som du kan forny.
Sender en test i workflow-editoren en hændelse?
Nej. Kun rigtige kørsler sender hændelser.
Dit næste produkt
fortjener mere end kopiér og indsæt.
Giv dit AI-team de første produkter at arbejde med.
Marcus
Amazon