Opérations
Une opération est votre logique, appelée via Fóir. Vous hébergez un endpoint HTTP et enregistrez son URL, et Fóir lui envoie une charge utile signée, relance en cas d'échec et enregistre le résultat.
Comment elle est déclenchée
Une opération s'exécute depuis un bouton de la console, un champ de l'éditeur d'enregistrement, un hook de cycle de vie, une planification ou un appel à l'API publique. Chacune reçoit une mutation GraphQL typée propre, générée à partir de son schéma d'entrée et de sortie, de sorte qu'une opération de clé ai-summarize devient executeAiSummarize. Les préconditions et les quotas d'utilisation décident qui peut l'exécuter et à quelle fréquence.
Synchrone ou en arrière-plan
En mode sync, l'appelant attend et le corps de votre réponse est le résultat. Le délai d'expiration est de 30 secondes par défaut et peut aller jusqu'à cinq minutes. En mode async, votre endpoint répond 202 puis signale plus tard la progression, l'achèvement, l'échec ou l'annulation au moyen d'un jeton de rappel. Il dispose par défaut de 24 heures pour rappeler avant que l'exécution soit marquée comme expirée.
Relances et file des échecs définitifs
Un appel échoué est relancé, trois fois par défaut, et un disjoncteur s'ouvre après cinq échecs et refuse les appels pendant 60 secondes. Une exécution en file qui épuise ses relances va dans la file des échecs définitifs, où vous pouvez l'inspecter, la relancer ou l'écarter. Une clé d'idempotence sur l'appel fait qu'une relance reprend l'exécution de la première tentative, ce qui évite de faire le travail deux fois.
L'enregistrement d'exécution
Chaque exécution est enregistrée avec un statut, sa durée, le résultat ou l'erreur, le déclencheur, le nombre de relances et la progression.
Appels à des API tierces
Une écriture en passthrough n'a aucun de vos services derrière elle. Fóir appelle lui-même l'API tierce à partir d'un modèle de requête, avec des identifiants tirés des secrets. Une opération resolver expose une API tierce comme une requête GraphQL ou comme un champ d'un modèle, avec mise en cache et regroupement par lots.
Lire le détail
Le guide des opérations couvre l'enregistrement d'un endpoint, la charge utile qu'il reçoit, les deux modes et l'historique des exécutions.