DEV Community

Argun Sayilgan
Argun Sayilgan

Posted on

Cómo un agente de IA construye documentos y presentaciones página a página con una API OpenAPI

Aviso: soy el desarrollador de Eddocu, el producto del que hablo.

Llevo tiempo construyendo Eddocu, un editor de PDF, DOCX y PPTX con su propio motor de documentos (no es un envoltorio de otro programa). Funciona en el navegador y en Mac, Windows, Linux, iPhone/iPad y Android, y las apps funcionan sin conexión.

Los agentes de IA escriben bien el texto de un informe o una presentación; lo pesado es convertirlo en páginas de verdad. Para eso Eddocu tiene una API REST pequeña: el agente crea un documento o una presentación y lo construye página a página.

Para que quede claro el alcance: la API crea documentos y añade, reemplaza, borra y lee páginas. No edita PDF existentes, no convierte y no exporta.

La API

La especificación OpenAPI 3.1 es pública:

curl -s https://eddocu.com/api/v1/ai-tools/openapi.json | jq '.paths | keys'
Enter fullscreen mode Exit fullscreen mode
Método Ruta Qué hace
POST /api/v1/ai-tools/documents Crea un documento (documentType: slide o doc)
POST /api/v1/ai-tools/documents/{documentId}/pages Añade una página
PUT /api/v1/ai-tools/documents/{documentId}/pages/{pageId} Reemplaza el contenido de una página
DELETE /api/v1/ai-tools/documents/{documentId}/pages/{pageId} Borra una página
GET /api/v1/ai-tools/documents/{documentId} Lee la información del documento

Las llamadas van a https://app.eddocu.com con autenticación Bearer. La clave empieza por eddocu_ak_ y se crea en los ajustes de la cuenta.

Cada página es HTML posicionado

La página se envía como HTML con posiciones absolutas y el motor lo convierte a su propio formato de página:

  • un único <div> raíz con position:relative y width/height en px
  • un id único en cada elemento
  • todos los hijos con position:absolute y left, top, width, height en px
  • el texto va en un class="textbox", con un class="line" por línea
  • las imágenes son <img> solo con alt (sin src; la imagen se genera a partir de la descripción)
  • las formas son <div> normales con fondo o borde
  • tamaños por defecto: diapositiva 1920×1080, documento 816×1056 (US Letter)

Ejemplo mínimo

export EDDOCU_KEY=eddocu_ak_xxxxxxxx   # tu clave

# 1. Crear una presentación
curl -s -X POST https://app.eddocu.com/api/v1/ai-tools/documents \
  -H "Authorization: Bearer $EDDOCU_KEY" -H "Content-Type: application/json" \
  -d '{"title":"API test","documentType":"slide"}'
# => {"documentId": 123, "accessToken": "..."}

# 2. Añadir una página
curl -s -X POST https://app.eddocu.com/api/v1/ai-tools/documents/123/pages \
  -H "Authorization: Bearer $EDDOCU_KEY" -H "Content-Type: application/json" \
  -d '{
    "width": 1920, "height": 1080,
    "html": "<div id=\"0\" style=\"position:relative;width:1920px;height:1080px;background:#ffffff;\"><div id=\"1\" class=\"textbox\" style=\"position:absolute;left:120px;top:100px;width:1200px;height:auto;\"><div class=\"line\"><span style=\"font-size:64px;font-weight:700;color:#1e293b;\">Hola, API</span></div></div><div id=\"2\" style=\"position:absolute;left:120px;top:200px;width:120px;height:6px;background:#3b82f6;\"></div></div>"
  }'
# => {"pageId": "...", "nodeCount": 3}
Enter fullscreen mode Exit fullscreen mode

Si haces demasiadas llamadas recibes 429: espera los segundos que indica la cabecera Retry-After.

Si un LLM genera las páginas, pon las reglas de HTML de arriba en su prompt de sistema y te devolverá HTML listo para enviar. Las mismas reglas están en el description de la especificación, así que un agente que lee OpenAPI puede trabajar solo con ella.

El servidor MCP (pequeño y de solo lectura)

También hay un servidor MCP en https://eddocu.com/mcp (Streamable HTTP, sin cuenta). Es de solo lectura y tiene dos herramientas: about_eddocu (datos públicos: plataformas, qué es gratis, precios, herramientas online, blog) y get_app_link (enlace de instalación para iOS, Android, Windows o Mac). No toca documentos.

claude mcp add --transport http eddocu https://eddocu.com/mcp
Enter fullscreen mode Exit fullscreen mode

Pruébalo

Más sobre agentes y la API: https://eddocu.com/agents

El editor es gratis para uso personal y sin marca de agua. Hoy lo usan 500 personas (100 cada día) y se han abierto o editado 10 000 documentos.

La API todavía está tomando forma. Me encantaría leer qué endpoint les falta o qué HTML no pasa bien. Déjenlo en los comentarios.

Top comments (0)