# Documentación para agentes de IA

> Cómo consumir la documentación de la API v2 de Legaldoc.io desde un LLM, un agente de desarrollo o cualquier herramienta automatizada.

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`](/guides/integration-guide.md) | Quieres pasarle a un LLM una sola página, o copiarla al chat sin el ruido del HTML.                                |
| [**`/llms.txt`**](/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](https://llmstxt.org/). |
| [**`/llms-full.txt`**](/llms-full.txt) | Quieres cargar todas las guías completas en el contexto de una sola vez.                                           |
| [**`/llms-small.txt`**](/llms-small.txt) | Lo mismo, pero en versión reducida para modelos con ventana de contexto chica.                                     |
| [**OpenAPI 3.1**](/openapi/legaldoc-v2.json) | 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). |

<Aside type="note" title="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.
</Aside>

## 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`:

```text
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:

```text
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`:

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

El flujo completo está en la [Guía de Integración](/guides/integration-guide/), y lo que agrega Firma Electrónica Avanzada en su [capítulo dedicado](/guides/fea-orquestacion/).