OpenAPI y llms.txt
Descripciones de la API legibles por máquina.
Dos archivos describen la API de forma legible por máquina: openapi.json para generadores de código y clientes de API, llms.txt para agentes de IA.
openapi.json
La especificación en formato OpenAPI 3.0 describe los endpoints con sus parámetros principales, respuestas, errores y autenticación. También cubre los eventos que entregan los webhooks. Para cualquier detalle, esta documentación es la referencia.
https://handelsregister.ai/openapi.json
Cómo usarla:
- Con un generador como OpenAPI Generator creas un cliente tipado para tu lenguaje.
- Importa el archivo en Postman, Insomnia o Bruno y tendrás todas las solicitudes a mano al momento.
- Los frameworks de agentes construyen a partir del archivo definiciones de herramientas para un modelo de lenguaje.
Abre la URL en tu navegador, guarda el archivo e impórtalo.
llms.txt
llms.txt resume la API como texto breve para modelos de lenguaje: endpoints, parámetros, funciones, precios y las reglas más importantes.
https://handelsregister.ai/llms.txt
Da la URL a tu agente de IA antes de que escriba código para la API. Así conoce los nombres reales de los parámetros y los campos de respuesta.