Convertir ficheros

​

Convierte un fichero

from doconda import Doconda

doconda = Doconda()  # lee DOCONDA_API_KEY

result = doconda.convert({"url": "https://ejemplo.com/contrato.pdf"}, "md")
print(result["text"][:60], result["pages"])

import { Doconda } from "@doconda/sdk"

const doconda = new Doconda() // lee DOCONDA_API_KEY

const result = await doconda.convert({ url: "https://ejemplo.com/contrato.pdf" }, "md")
console.log(result.text?.slice(0, 60), result.pages)

{
  "object": "conversion",
  "id": "doc_01JAB3H8K2M7V6X5T1R0NPQ4ZW",
  "from": "pdf",
  "to": "md",
  "text": "# Contrato de arrendamiento\n\nEn Madrid, a…",
  "output": null,
  "pages": 7,
  "expires_at": null
}

​

Qué se convierte en qué

​

Lee el resultado

• md, txt, html y csv vuelven en text, y output es null. Doconda borra el resultado en cuanto responde, así que después GET /convert/{id} devuelve 404 not_found.
• docx, pdf, odt, rtf, xlsx y pptx vuelven en output, y text es null. output.url es un enlace de descarga que vale 5 minutos. El fichero se borra 15 minutos después de hacerse (expires_at); hasta entonces, GET /convert/{id} te da un enlace nuevo.

from pathlib import Path
import httpx

result = doconda.convert("notas.md", "docx")
Path("notas.docx").write_bytes(httpx.get(result["output"]["url"]).content)

import { writeFile } from "node:fs/promises"

const result = await doconda.convert("notas.md", "docx")
await writeFile("notas.docx", new Uint8Array(await (await fetch(result.output!.url)).arrayBuffer()))

• Word: títulos, listas, tablas, imágenes y notas al pie. Las formas, los cuadros de texto y los gráficos no pasan a Markdown, HTML ni RTF.
• PowerPoint: una sección por diapositiva (separadas por ---), el título como ##, las viñetas con su nivel, las tablas, las imágenes por su texto alternativo y las notas del orador como cita.
• Excel: una tabla por hoja visible, con los valores que muestran las celdas (fórmulas calculadas). A CSV, solo la primera hoja.
• PDF: títulos, párrafos, listas y tablas reconstruidos a partir de la página; fuera las cabeceras y pies repetidos y los números de página.
• PDF escaneados e imágenes: se leen con OCR.
• A PDF: los documentos llevan las mismas fuentes que usa Doconda en todo (Calibri como Carlito, Cambria como Caladea…).

​

Espera una conversión larga

​

Precio

• Las conversiones fallidas no se cobran ni cuentan para las 1000 gratis.
• Pasadas las gratis y sin saldo, la llamada se rechaza con 402 insufficient_balance.
• Una conversión no sale en la lista de documentos y no manda webhooks.
• Las conversiones cuentan para el límite de 120 documentos por minuto de cada organización; por encima, 429 rate_limited.

​

Cuatro formas de pasar un fichero

curl https://api.eu.doconda.com/v1/convert \
  -H "Authorization: Bearer $DOCONDA_API_KEY" \
  -F to=pdf \
  -F file=@informe.docx

• Los ficheros tienen un máximo de 20 MB.
• Las URL tienen que apuntar a direcciones públicas; las privadas y locales se rechazan.
• Un fichero enviado por URL, base64 o multipart se borra 15 minutos después de la llamada.

​

Desde el SDK

text = doconda.convert("file_01JAB3…", "md")["text"]
url = doconda.convert("https://ejemplo.com/notas.md", "docx")["output"]["url"]
pdf = doconda.convert(b"# Notas\n\nPrimer punto.", "pdf", filename="notas.md")

const { text } = await doconda.convert("file_01JAB3…", "md")
const { output } = await doconda.convert("https://ejemplo.com/notas.md", "docx")
const pdf = await doconda.convert(new TextEncoder().encode("# Notas\n\nPrimer punto."), "pdf", { filename: "notas.md" })

​

Siguientes pasos