Documentación

Quickstart

1. 1
   Crea una cuenta en documento.md y entra al dashboard.
2. 2
   Genera una API Key desde Dashboard → API Keys. Copia el valor completo (solo se muestra una vez).
3. 3
   Haz tu primera llamada usando el header Authorization: Bearer dtmd_live_...

Autenticación

Todas las peticiones a /v1/* requieren una API Key. Usa Bearer token (preferido) o el header X-API-Key:

# Preferido
Authorization: Bearer dtmd_live_xxxxxxxxxxxxx

# Alternativa
X-API-Key: dtmd_live_xxxxxxxxxxxxx

⚠️ Las peticiones sin API Key reciben 401 missing_api_key.

POST /v1/convert

Convierte un documento a Markdown. Sube el archivo como multipart/form-data.

curl -X POST "https://documento.md/v1/convert" \
  -H "Authorization: Bearer dtmd_live_xxxxx" \
  -F "file=@documento.pdf" \
  -F "wait=true"

import requests

with open("documento.pdf", "rb") as f:
    resp = requests.post(
        "https://documento.md/v1/convert",
        headers={"Authorization": "Bearer dtmd_live_xxxxx"},
        files={"file": f},
        data={"wait": "true"},
    )
print(resp.json()["markdown"])

const form = new FormData();
form.append("file", fs.createReadStream("documento.pdf"));
form.append("wait", "true");

const resp = await fetch("https://documento.md/v1/convert", {
  method: "POST",
  headers: { Authorization: "Bearer dtmd_live_xxxxx" },
  body: form,
});

Parámetros: file (obligatorio), output=markdown, wait=true|false.

GET /v1/conversions/{id}

Consulta el estado de una conversión asíncrona:

curl "https://documento.md/v1/conversions/{id}" \
  -H "Authorization: Bearer dtmd_live_xxxxx"

{
  "id": "conv_123",
  "status": "completed",
  "markdown": "# Resultado...",
  "download_url": "https://documento.md/v1/conversions/conv_123/download"
}

GET /v1/me

Inspecciona tu key, plan y uso actual:

{
  "user_id": "usr_123",
  "plan": "free",
  "limits": { "rate_limit_per_minute": 5, "daily_conversions": 50 },
  "usage": { "conversions_today": 12, "remaining_today": 38 }
}

Formatos soportados

Rate limiting

Cada respuesta incluye estos headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1710000000
# Solo cuando se excede:
Retry-After: 30

Códigos de error

Todos los errores usan el mismo formato JSON:

{
  "error": {
    "code": "invalid_file_type",
    "message": "File type not allowed.",
    "details": { "allowed_extensions": ["pdf", "docx", ...] }
  }
}

Privacidad y retención

• ✓ Los archivos originales no se guardan después de la conversión.
• ✓ Los resultados se retienen 24 horas y luego expiran.
• ✓ Puedes borrar un resultado en cualquier momento con DELETE /v1/conversions/{id}.
• ✓ Las API Keys se almacenan hasheadas (sha256), nunca en texto plano.