Operaciones
Una operación es tu lógica, llamada a través de Fóir. Tú alojas un endpoint HTTP y registras su URL, y Fóir le envía un payload firmado, reintenta si falla y registra el resultado.
Cómo se activa una
Una operación se ejecuta desde un botón de la consola, un campo del editor de registros, un hook de ciclo de vida, una programación o una llamada a la API pública. Cada una recibe su propia mutación GraphQL tipada generada a partir de su esquema de entrada y salida, de modo que una operación con la clave ai-summarize se convierte en executeAiSummarize. Las precondiciones y las cuotas de uso deciden quién puede ejecutarla y con qué frecuencia.
Síncrona o en segundo plano
En modo síncrono quien llama espera y el cuerpo de tu respuesta es el resultado. El tiempo de espera es de 30 segundos por defecto y puede fijarse hasta en cinco minutos. En modo asíncrono tu endpoint responde 202 y más tarde informa del progreso, la finalización, el fallo o la cancelación mediante un token de callback. Tiene 24 horas por defecto para responder antes de que la ejecución se marque como agotada por tiempo.
Reintentos y cola de mensajes fallidos
Una llamada fallida se reintenta, tres veces por defecto, y un circuit breaker se abre tras cinco fallos y rechaza las llamadas durante 60 segundos. Una ejecución en cola que agota sus reintentos va a la cola de mensajes fallidos, donde puedes inspeccionarla, reintentarla o descartarla. Una clave de idempotencia en la llamada hace que un reintento adopte la ejecución del primer intento, de modo que el trabajo no se hace dos veces.
El registro de ejecución
Cada ejecución se registra con un estado, su duración, el resultado o el error, el activador, el número de reintentos y el progreso.
Llamadas a APIs de terceros
Una escritura directa no tiene detrás ningún servicio tuyo. Fóir llama él mismo a la API de terceros a partir de una plantilla de solicitud, con credenciales tomadas de los secretos. Una operación de resolver expone una API de terceros como una consulta GraphQL o como un campo de un modelo, con caché y agrupación en lotes.
Lee el detalle
La guía de operaciones cubre cómo registrar un endpoint, el payload que recibe, ambos modos y el historial de ejecuciones.