Webhook
Webhook: i vostri strumenti avvisati non appena un’elaborazione termina.
Quando l’arricchimento o la generazione di un lotto si completa, non riesce o viene interrotta, Upsellr invia un evento firmato all’indirizzo che scegliete. Il vostro strumento prosegue: pubblicazione, revisione, esportazione.
- Categoria
- API
- Direzione
- Invio di eventi
- Formato
- JSON firmato in HMAC-SHA256
- Indirizzi
- Fino a 25 per organizzazione
- Nuovi tentativi
- Fino a 6 tentativi, su più di una giornata
- Configurazione
- Un indirizzo HTTPS e un segreto
- Piani
- Piano Enterprise
- Editore
- Upsellr
01Cosa fanno i webhook
Il segnale che fa avanzare i vostri strumenti.
- 01
Un evento al termine di ogni elaborazione
Completata, non riuscita o interrotta: al termine di ogni elaborazione di arricchimento o di generazione, Upsellr invia l’evento con il dettaglio dell’elaborazione.
- 02
Firmato, per essere verificato
Ogni invio porta un identificativo, un timestamp e una firma HMAC-SHA256 calcolata con il vostro segreto: il vostro strumento verifica che provenga davvero da Upsellr.
- 03
Ritentato finché non viene ricevuto
Senza una risposta 2xx entro 10 secondi, Upsellr ritenta dopo 1 minuto, 5 minuti, 30 minuti, 4 ore e infine 24 ore.
- 04
Un registro di ogni invio
Stato, codice HTTP, numero di tentativi e contenuto: ogni consegna si consulta per 7 giorni, e un invio non riuscito si ripete con un clic.
- 05
Concatenate i vostri strumenti
Pubblicate, avvisate un team o avviate un’esportazione non appena le schede sono pronte: il webhook dà il segnale, il vostro strumento fa il resto.
- 06
Mantenete il controllo
Disattivate un indirizzo, cambiatene il segreto o eliminatelo: i suoi tentativi in sospeso vengono annullati.
02Per iniziare
Collegato in pochi minuti.
- 01
Aprite le impostazioni dell’organizzazione
Sezione API e webhook, riservata ai proprietari e agli amministratori.
- 02
Aggiungete un indirizzo
Un URL in HTTPS, raggiungibile da internet.
- 03
Copiate il segreto
Viene mostrato una sola volta e serve a verificare la firma di ogni invio.
- 04
Verificate la firma
Ricalcolate la firma HMAC-SHA256 del timestamp e del contenuto, e rifiutate un invio troppo vecchio.
- 05
Rispondete in fretta
Una risposta 2xx in meno di 10 secondi, poi gestite il seguito dal vostro lato.
03Eventi
Gli eventi inviati.
| Evento | Inviato | Ritentato se necessario |
|---|---|---|
| Elaborazione completata (workflow.run.completed) | Sì | Sì |
| Elaborazione non riuscita (workflow.run.failed) | Sì | Sì |
| Elaborazione interrotta (workflow.run.stopped) | Sì | Sì |
Compatibilità e requisiti
- Il piano Enterprise
- Un indirizzo HTTPS pubblico, sulla porta 443
- Un ruolo di proprietario o amministratore
- Una risposta 2xx in meno di 10 secondi
- Consiglio: deduplicate in base all’identificativo dell’evento
Il controllo resta vostro
Affidabili per progettazione.
- Firmati in HMAC-SHA256, con un segreto proprio per ogni indirizzo
- Consegnati almeno una volta: deduplicate in base all’identificativo dell’evento
- Ritentati fino a 6 volte, su più di una giornata
- Inviati in HTTPS, solo verso indirizzi pubblici
04Domande
Domande sui webhook di Upsellr.
I webhook sono inclusi nel mio piano?
Sono riservati al piano Enterprise, come l’API.
Quali eventi vengono inviati?
La fine di un’elaborazione di arricchimento o di generazione: completata, non riuscita o interrotta. Ogni evento contiene il dettaglio dell’elaborazione.
Come verifico che un invio provenga da Upsellr?
Ricalcolate la firma HMAC-SHA256 del timestamp e del contenuto con il vostro segreto, confrontatela con l’intestazione X-Upsellr-Signature, e rifiutate un invio di oltre 5 minuti.
Cosa succede se il mio server non risponde?
Senza una risposta 2xx entro 10 secondi, Upsellr ritenta dopo 1 minuto, 5 minuti, 30 minuti, 4 ore e infine 24 ore. Un invio non riuscito si può anche ripetere manualmente dal registro.
Posso ricevere due volte lo stesso evento?
Sì, è possibile: la consegna è garantita almeno una volta, senza ordine garantito. Deduplicate in base all’identificativo dell’evento.
Per quanto tempo viene conservato il registro?
7 giorni, con lo stato, il codice HTTP, il numero di tentativi e il contenuto di ogni invio.
Quanti indirizzi posso dichiarare?
Fino a 25 per organizzazione, ognuno con il proprio segreto, che potete rinnovare.
Un test nell’editor dei workflow invia un evento?
No. Solo le elaborazioni reali inviano eventi.
Il tuo prossimo prodotto
merita più di un copia e incolla.
Affida al tuo team IA i primi prodotti su cui lavorare.
Marcus
Amazon