Hook del ciclo di vita
Un hook si sottoscrive a un evento ed esegue una delle tue operazioni quando scatta. Ogni consegna viene memorizzata con il suo stato, così una fallita può essere trovata e rieseguita.
Gli eventi
Gli eventi di record scattano quando un record viene creato, aggiornato, eliminato, pubblicato o ritirato dalla pubblicazione. Altri eventi di progetto riguardano i tuoi utenti e le loro sessioni, l'esito di un'operazione, import terminati, migrazioni e modifiche in blocco, e la vita di una organizzazione, dalla creazione a una modifica dei suoi membri. Un ulteriore insieme (appartenenza al team, piano, progetto e modifiche degli inviti) si sottoscrive sul workspace.
Dichiarare un hook
defineHook nella configurazione indica un evento e la chiave dell'operazione da eseguire. Un filtro restringe l'hook per uguaglianza sulle chiavi di primo livello dell'evento, di solito a un solo modello. Un hook impostato nella console può anche avere come destinazione, tra quelle integrate, una notifica.
Cosa porta una consegna
Una consegna è un HTTP POST all'endpoint dell'operazione. È autenticata da un token di breve durata, inviato in X-Foir-Token come header. Lo verifichi rispetto al JWKS di Fóir, e non esiste un header con firma HMAC. Il corpo dice cosa è cambiato, tramite id del record e chiave del modello, e non contiene il contenuto dei campi. Il ricevente rilegge il record.
Tracciamento, retry e dead-letter queue
Ogni consegna è una riga memorizzata con uno stato. foir hooks elenca le consegne fallite di un hook, ne riesegue una e invia una consegna sintetica per testare un endpoint. I retry e il circuit breaker appartengono all'operazione che l'hook esegue. Un'esecuzione che esaurisce i tentativi finisce nella dead-letter queue, dove può essere ispezionata, ritentata o scartata.
Ordine e cicli
L'ordine di consegna non è garantito. Ogni consegna porta un numero di sequenza, così un ricevente può applicare l'ultima scrittura che vince (last-write-wins), e un id di esecuzione per scartare i duplicati. Un hook che attiva se stesso non può andare fuori controllo: un'operazione già presente nella catena delle cause non viene eseguita di nuovo, e una catena si ferma a tre salti.
Leggi i dettagli
La guida agli hook del ciclo di vita tratta gli eventi, la dichiarazione di un hook, e l'ispezione e la riesecuzione delle consegne.