Disparador de API
Inicia un flujo de trabajo desde una solicitud HTTP autenticada
Descripción general
El disparador de API expone tu flujo de trabajo como un punto de conexión HTTP seguro. EnvÃa datos JSON al punto de conexión y tu flujo de trabajo los procesa inmediatamente. Las llamadas a la API siempre se ejecutan contra tu última implementación.
Configurar formato de entrada
Añade un campo de Formato de entrada para cada parámetro. Las claves de salida en tiempo de ejecución reflejan el esquema y también están disponibles bajo <api.input>.
- type: string
name: userId
value: demo-user # optional manual test value
- type: number
name: maxTokensLas ejecuciones manuales en el editor utilizan la columna value para que puedas realizar pruebas sin enviar una solicitud. Durante la ejecución, el resolutor completa tanto <api.userId> como <api.input.userId>.
Ejemplo de solicitud
curl -X POST \
https://sim.ai/api/workflows/WORKFLOW_ID/execute \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_KEY' \
-d '{"userId":"demo-user","maxTokens":1024}'Las respuestas exitosas devuelven el resultado de ejecución serializado del Ejecutor. Los errores muestran fallos de validación, autenticación o del flujo de trabajo.
Referencia de salida
| Referencia | Descripción |
|---|---|
<api.field> | Campo definido en el formato de entrada |
<api.input> | Cuerpo completo estructurado de la solicitud |
Si no se define un formato de entrada, el ejecutor expone el JSON sin procesar solo en <api.input>.
Un flujo de trabajo puede contener solo un disparador de API. Publica una nueva implementación después de realizar cambios para que el punto de conexión se mantenga actualizado.