Operazioni
Un'operazione è la tua logica, richiamata tramite Fóir. Ospiti un endpoint HTTP e registri il suo URL, e Fóir gli invia un payload firmato, riprova in caso di errore e registra il risultato.
Come viene attivata
Un'operazione parte da un pulsante nella console, da un campo nell'editor dei record, da un hook del ciclo di vita, da una pianificazione o da una chiamata all'API pubblica. Ognuna ottiene una propria mutation GraphQL tipizzata generata dal suo schema di input e output, quindi un'operazione con chiave ai-summarize diventa executeAiSummarize. Precondizioni e quote di utilizzo decidono chi può eseguirla e con che frequenza.
Sincrona o in background
In modalità sync il chiamante attende e il corpo della tua risposta è il risultato. Il timeout predefinito è 30 secondi e può essere portato fino a cinque minuti. In modalità async il tuo endpoint risponde 202 e in seguito segnala avanzamento, completamento, errore o annullamento tramite un token di callback. Ha 24 ore per impostazione predefinita per richiamare prima che l'esecuzione venga segnata come scaduta.
Retry e dead-letter queue
Una chiamata fallita viene ritentata, tre volte per impostazione predefinita, e un circuit breaker si apre dopo cinque errori e rifiuta le chiamate per 60 secondi. Un'esecuzione in coda che esaurisce i tentativi finisce nella dead-letter queue, dove puoi ispezionarla, ritentarla o scartarla. Una chiave di idempotenza sulla chiamata fa sì che un retry riprenda l'esecuzione del primo tentativo, così il lavoro non viene svolto due volte.
Il record dell'esecuzione
Ogni esecuzione viene registrata con uno stato, la durata, il risultato o l'errore, il trigger, il numero di retry e l'avanzamento.
Chiamate ad API di terze parti
Una scrittura pass-through non ha dietro alcun tuo servizio. Fóir chiama direttamente l'API di terze parti da un template di richiesta, con credenziali prese dai secret. Un'operazione resolver espone un'API di terze parti come query GraphQL o come campo di un modello, con caching e batching.
Leggi i dettagli
La guida alle operazioni tratta la registrazione di un endpoint, il payload che riceve, entrambe le modalità e la cronologia delle esecuzioni.