Conecta KI.ordo con tus programas.
Llama a agentes y flujos mediante una API REST sencilla o inicia flujos por webhook.
curl -X POST https://app.www.kiordo.de/api/v1/agents/AGENT_ID/run \
-H "Authorization: Bearer ordo_…" \
-d '{"message":"¿Cómo funciona un proyecto?"}'{ "answer": "En cuatro pasos …",
"citations": [ … ] }Qué incluye.
Claves API
Por espacio de trabajo, con nombre, prefijo y último uso. Revocables en cualquier momento.
Llamar a un agente
POST /api/v1/agents/{id}/run – respuesta con fuentes y número de tokens.
Ejecutar un flujo
POST /api/v1/flows/{id}/run – resultado e ID de ejecución.
Webhooks
Una dirección secreta por flujo, sin clave – práctica para formularios y otras herramientas.
Primera llamada en tres pasos.
- 1
Crear una clave
Crea una clave API en los ajustes y guárdala en un lugar seguro.
- 2
Copiar un ejemplo
En los ajustes, justo debajo de las claves, hay llamadas listas con el ID correcto.
- 3
Llamar
Envía una petición POST con la clave en la cabecera. Listo.
Preguntas sobre la API.
¿Hay límites?
Sí. Las peticiones por dirección están limitadas, y un límite mensual de tokens protege frente a costes inesperados.
¿Qué diferencia hay entre la API y un webhook?
La API necesita una clave y puede llamar a agentes y flujos. Un webhook es una dirección secreta para un único flujo, práctica para formularios y servicios de automatización.
¿Qué pasa si se pierde una clave?
Revócala en los ajustes y crea una nueva. La antigua deja de funcionar al instante.