È possibile notificare eventi specifici che si verificano in Fonzip ai propri server tramite trigger web e registrare tali eventi nel proprio sistema.
Cos'è un trigger web? Come posso crearlo?
I trigger web sono una funzionalità che invia notifiche all'indirizzo desiderato quando si verifica un evento nel sistema. È possibile creare un trigger web accedendo alla sezione Impostazioni > Avanzate > Trigger Web dal menu a sinistra e cliccando su Crea Trigger Web.
Nella schermata di creazione, inserisci il nome del trigger e l'indirizzo a cui desideri che la richiesta venga inviata. Seleziona quali stati desideri ricevere e salva.
Puoi testare il trigger web dalla sezione delle operazioni sul lato destro.
Qual è il contenuto di un trigger web?
Come specificato nella sezione https://fonzip.com/api/v2/docs#operation/createWebhook, un JSON viene inviato all'URL specificato per il trigger web.
{
"id": 0,
"webhook_id": 0,
"operation": 1,
"status": 0
}
id: Numero di registrazione dell'oggetto correlato
webhook_id: ID del tuo trigger web
operation: tipo di operazione ( 1: Donazione, 2: Quota associativa, 3: Biglietto, 4: Modulo, 5: E-card, 6: Campagna di donazione)
status: stato dell'operazione (0: campagna creata, 3: riuscita, 4: rimborso, 5: errore)
Ho ricevuto una richiesta di trigger web, cosa devo fare?
Dopo aver ricevuto la richiesta del trigger web nel tuo sistema, puoi connetterti tramite API con il numero di registrazione dell'operazione correlata e recuperarla nel tuo sistema.
Ad esempio, se ricevi una richiesta nel tuo sistema quando si verifica una donazione, puoi richiamare i dettagli della donazione utilizzando la funzione Ottieni Dettagli Donazione ( https://fonzip.com/api/v2/docs#operation/getDonationDetails ) e salvarli nel tuo sistema.
Il trigger web non è arrivato / È arrivato ma si è verificato un errore, cosa devo fare?
Fonzip tenta di attivare un'operazione 3 volte e, se fallisce, non riprova. Per prevenire potenziali problemi, puoi elencare le operazioni giornaliere una volta al giorno, confrontare il numero totale di operazioni con il tuo sistema e recuperare quelle mancanti dall'elenco.
Ad esempio, puoi confrontare il parametro total quando elenchi tutte le donazioni del giorno precedente utilizzando la funzione Elenca Donazioni https://fonzip.com/api/v2/docs#operation/getDonationList con il tuo sistema. Non dimenticare di eseguire query in base al fuso orario quando effettui queste richieste.