Webhook in uscita affidabili: stato di consegna chiaro per ogni integrazione

L'integrazione con magazzini, ERP o portali di trasporto non serve a controllare ogni pochi secondi se qualcosa è cambiato nel Controllo della Slot Temporale. I webhook in uscita inoltrano un evento man mano che si verifica, mantenendo un risultato chiaro di ogni tentativo di consegna.

Dall'evento alla consegna senza sondaggio

Quando una prenotazione o un ordine cambia, TSC crea un evento e seleziona le iscrizioni attive al webhook che tracciano quel tipo. Ogni abbonamento riceve un JSON versionato tramite HTTP POST verso il suo indirizzo di destinazione.

1. TSC rileva il cambiamento e crea un evento unico.
2. Gli abbonamenti attivi vengono confrontati con il suo tipo.
3. Per ogni ordine corrispondente verrà creata una consegna separata.
4. La risposta del sistema target determina lo stato risultante o il tentativo successivo.

L'elaborazione è basata su eventi e avviene in modo asincrono. Il sistema connesso non deve gravare l'API con frequenti interrogazioni di polling e può rispondere poco dopo il cambiamento effettivo.

Il registro delle consegne sostituisce le ipotesi

L'amministratore può vedere la consegna in un unico punto e può filtrarla sia per abbonamento webhook che per stato. Per ogni record, c'è un tipo di evento, un numero di tentativi, lo stato dell'ultimo HTTP, il tempo dell'ultimo tentativo e una breve informazione sull'errore.

Cosa succede quando il sistema target non è disponibile

Gli errori di rete, le risposte HTTP 429 e gli errori server 5xx si ripetono con intervalli crescenti, in un massimo di cinque tentativi. Gli errori client comuni di 4xx eccetto 429 andranno direttamente allo stato DeadLetter, perché il tentativo automatico successivo di solito finirebbe uguale.

Dopo la riparazione del sistema ricevente, l'utente autorizzato può utilizzare Resend. TSC resetta il numero di tentativi, rimuove l'ultimo errore e restituisce la consegna alla coda. Pertanto, non è necessario richiamare l'evento aziendale originale.

Eventi che corrispondono al traffico reale

Il catalogo non termina con creazioni, modifiche e cancellazioni generiche. Un'integrazione può anche rimuovere punti specifici nel ciclo di vita della prenotazione e dell'ordine, come reservation.pendingLibroreservation.vehicle.platechangedreservation.markedasarrivalreservation.approval.approvedreservation.processingstartedreservation.markedasdeparted, A o order.confirmedA.

L'abbonamento seleziona solo gli eventi necessari. Il sistema di destinazione non deve derivare retroattivamente dal cambiamento generale ciò che è realmente accaduto nell'operazione.

Messaggi firmati ed elaborazione sicura

L'indirizzo webhook utilizza HTTPS. TSC invia un wrapper JSON con schemaVersioncampi eeventeventIdtenantIddataoccurredAt . Il corpo della richiesta è firmato con HMAC-SHA256, e il destinatario riceve una firma nell'intestazione X-TSC-Signature insieme a un timestamp.X-TSC-Timestamp

Il sistema ricevente dovrebbe validare la firma e il timestamp, processarli eventId idempotentemente e restituire uno stato 2xx riuscito solo dopo aver ricevuto in modo sicuro il messaggio. Il segreto può essere ruotato quando la sicurezza viene modificata.

Cosa apporta alle operazioni di integrazione

• Meno query di sondaggio e meno onere per entrambe le parti dell'integrazione.
• stato leggibile di ogni consegna senza cercare in diversi strumenti di loging,
• Recupero automatico da errori temporanei
• Ritentazione manuale controllata dopo che il sistema bersaglio è stato riparato.
• Origine verificabile e integrità di ogni messaggio.

Il risultato non è solo una trasmissione più rapida degli eventi, ma anche un'integrazione operativamente prevedibile: il team può vedere cosa è stato consegnato, cosa aspetta il prossimo tentativo e cosa richiede intervento.

Vuoi collegare TSC a un ERP, WMS o a una tua piattaforma di integrazione? Sfoglia le opzioni di integrazione o descrivici il tuo scenario.