La API de Ultineo AI
Ejecute las aplicaciones del catálogo desde su propio software. La API habla JSON sobre HTTPS, autentica cada llamada con una clave de proyecto y responde a todas las llamadas con el mismo formato.
Construida en torno a tres recursos
- Catálogo
Las aplicaciones publicadas, las más usadas primero, cada una con los campos de entrada que espera.
- Ejecuciones
Una llamada lanza una aplicación con sus entradas; otra consulta la ejecución con su respuesta.
- Claves
Claves de proyecto con permisos, una caducidad opcional y un estado que puede desactivar.
Autenticación y permisos
- Una clave de portador
Envíe la clave de su proyecto en la cabecera Authorization de cada llamada, solo a través de HTTPS.
- Limitada a un proyecto
Una clave está vinculada a un proyecto y nunca puede leer ni escribir los datos de otro proyecto, sea cual sea la solicitud.
- Guardada como hash
Solo se conserva un hash de la clave, por lo que una clave se muestra completa una sola vez. Una clave perdida se sustituye, nunca se recupera.
Lance una ejecución y lea su respuesta
- Crear
Indique la aplicación y facilite un valor por cada campo de entrada, identificado con el nombre de campo que devuelve el catálogo.
- Seguir
Las ejecuciones son asíncronas: consulte la ejecución hasta que su estado sea terminada o fallida. Ambos estados son definitivos.
- Leer
Una ejecución terminada incluye su respuesta, su duración y sus recuentos de tokens de entrada y de salida.
Un mismo formato para cada respuesta
- Siempre los mismos tres campos
Cada respuesta incluye el código de estado, un título breve y el resultado, tanto en caso de éxito como de error.
- Mensajes estables
Los mensajes de error son cadenas estables en inglés que indican el permiso que falta o el valor rechazado.
- Límites del plan explícitos
Una llamada que el plan no cubre, o que superaría su cuota, se rechaza con su propio código de estado.
Obtener una clave
El acceso a la API se incluye en los planes de pago de Ultineo AI. Todavía no hay registro autónomo: nuestro equipo abre su proyecto y le entrega su primera clave.
Conecte su software a Ultineo AI
Díganos qué quiere automatizar y abriremos su proyecto y su clave de API.
Preguntas sobre la API
Los planes de pago. El plan gratuito da acceso a las aplicaciones sin la API.
No. Las instrucciones pertenecen al propietario de la aplicación. La API devuelve los campos de entrada, que son lo que rellena quien hace la llamada.
Crear una ejecución responde de inmediato con el nuevo estado. Consulte la ejecución hasta que termine para obtener la respuesta.
Sí. Cada clave tiene permisos y una caducidad opcional, y una clave nunca puede crear otra clave con permisos más amplios que los suyos.