Documentación para agentes de IA

Esta documentación está pensada para que la lean tanto personas como agentes de IA. Todo el contenido se genera como HTML estático y Markdown plano.

Qué formato conviene usar

Formato	Úsalo cuando…
Markdown por página — p. ej. /guides/integration-guide.md	Quieres pasarle a un LLM una sola página, o copiarla al chat sin el ruido del HTML.
/llms.txt	Quieres que el agente primero descubra qué contiene el sitio y después decida qué leer. Es el índice según el estándar llmstxt.org.
/llms-full.txt	Quieres cargar todas las guías completas en el contexto de una sola vez.
/llms-small.txt	Lo mismo, pero en versión reducida para modelos con ventana de contexto chica.
OpenAPI 3.1	Tu herramienta entiende OpenAPI: es la fuente de verdad de la referencia de API (Envelope, Recipients, Fields, Items, Attachments, Folder, Embedding — con schemas y autenticación).

Cómo se reparte el contenido

llms-full.txt contiene las guías (Guía de Integración y Firma Electrónica Avanzada). La referencia de API no se duplica ahí: para eso está la especificación OpenAPI, que ya es machine-readable y siempre está sincronizada con la documentación publicada.

Markdown de cada página

Cada página de guía se publica también como Markdown plano: agrega .md a su ruta.

https://developers.legaldoc.io/guides/integration-guide.md
https://developers.legaldoc.io/guides/fea-orquestacion.md

Además, arriba de cada guía hay botones para copiar el Markdown al portapapeles, verlo en crudo, o abrir esa página directamente en Claude, ChatGPT o Gemini con el contexto ya cargado.

Cómo apuntar un agente a esta documentación

Para un asistente con acceso a internet, el punto de entrada recomendado es llms.txt:

Lee https://developers.legaldoc.io/llms.txt y luego los documentos que
necesites de ahí para ayudarme a integrar la API v2 de Legaldoc.io.

Si va a generar código contra la API, conviene darle directamente la especificación OpenAPI:

Usa https://developers.legaldoc.io/openapi/legaldoc-v2.json como
referencia de la API v2 de Legaldoc.io y ayúdame a implementar el flujo
de firma (y Firma Electrónica Avanzada si corresponde).

Autenticación

Cualquier código que genere un agente necesita autenticarse. Todas las peticiones a la API llevan la API Key en el header Authorization, sin prefijo Bearer:

Authorization: {API_KEY}
Content-Type: application/json

El flujo completo está en la Guía de Integración, y lo que agrega Firma Electrónica Avanzada en su capítulo dedicado.