API de ODP a PDF#

La API de ODP a PDF convierte archivos de presentación OpenDocument (.odp, el formato de diapositivas nativo de LibreOffice y OpenOffice Impress) a PDF a través del endpoint POST /v1/convert/odp-to-pdf. Sube un archivo .odp como multipart/form-data y recibe los bytes del PDF sin procesar, o establece direct_download=false para obtener metadatos JSON con una URL de descarga prefirmada. El renderizado lo realiza LibreOffice en el servidor, por lo que el formato, las fuentes y el diseño propios de la presentación se conservan en el PDF de salida.

Endpoint#

POST /v1/convert/odp-to-pdf

Content-Type: multipart/form-data

Entrada aceptada: archivos .odp

Formato de salida: .pdf (application/pdf)

Autenticación#

Requiere una clave API privada o un token JWT obtenido de una clave pública.

X-API-Key: sk_your_private_key

O bien:

Authorization: Bearer <jwt_token>

Parámetros de la solicitud#

Opciones de PDF#

En los conversores de documentos basados en LibreOffice, el diseño de página (tamaño, márgenes, orientación) lo determina la configuración del propio documento. El único campo de pdf_options que aplica es:

Detalles de la conversión#

• Usa LibreOffice (vía unoserver) para renderizar los documentos en el servidor
• Se conservan el formato, las fuentes, el diseño de página y los medios incrustados del propio documento
• Tiempo límite de conversión: 120 segundos
• La salida reproduce fielmente el documento tal como se imprimiría desde LibreOffice

Respuesta#

Descarga directa (direct_download=true, predeterminado)#

HTTP 200 OK
Content-Type: application/pdf
Content-Disposition: inline; filename="document_20260405_123456789.pdf"

Devuelve los bytes del PDF sin procesar.

Respuesta con metadatos (direct_download=false)#

{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/odp-to-pdf/document_20260405_123456789.pdf",
    "filename": "document_20260405_123456789.pdf",
    "file_size": 67890,
    "conversion_time_seconds": 3.5
}

Ejemplos de código#

Python#

import requests

with open("document.odp", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/odp-to-pdf",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("document.odp", f)}
    )

with open("output.pdf", "wb") as out:
    out.write(response.content)

Node.js#

const form = new FormData();
form.append("file", fs.createReadStream("document.odp"));

const response = await fetch("https://api.enconvert.com/v1/convert/odp-to-pdf", {
    method: "POST",
    headers: { "X-API-Key": "sk_your_private_key" },
    body: form
});

fs.writeFileSync("output.pdf", Buffer.from(await response.arrayBuffer()));

PHP#

$ch = curl_init("https://api.enconvert.com/v1/convert/odp-to-pdf");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("document.odp")]
]);
$pdf = curl_exec($ch);
curl_close($ch);
file_put_contents("output.pdf", $pdf);

Go#

body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "document.odp")
file, _ := os.Open("document.odp")
io.Copy(part, file)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/odp-to-pdf", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", "sk_your_private_key")
resp, _ := http.DefaultClient.Do(req)

Con salida en escala de grises#

import requests
import json

with open("document.odp", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/odp-to-pdf",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("document.odp", f)},
        data={"pdf_options": json.dumps({"grayscale": True})}
    )

Respuestas de error#

Límites#

Preguntas frecuentes#

¿Cómo convierto una presentación ODP a PDF con una API REST?#

Envía una solicitud POST a /v1/convert/odp-to-pdf con el archivo .odp en un cuerpo multipart/form-data, autenticada con un encabezado X-API-Key o un JWT Authorization: Bearer. De forma predeterminada, la respuesta contiene los bytes del PDF convertido.

¿Puedo convertir presentaciones de LibreOffice u OpenOffice Impress a PDF con esta API?#

Sí. El endpoint acepta archivos .odp, el formato de presentación OpenDocument que usan LibreOffice y OpenOffice Impress, y los renderiza en el servidor con LibreOffice, de modo que la salida coincide con cómo se imprimiría la presentación desde LibreOffice.

¿Puedo obtener una URL de descarga en lugar de los bytes del PDF?#

Sí. Establece direct_download=false y la API devuelve metadatos JSON que incluyen una presigned_url, el filename de salida, file_size y conversion_time_seconds.

¿Puedo cambiar el tamaño de página, los márgenes o la orientación del PDF de salida?#

No. El diseño de página se toma de la configuración del propio documento ODP; el único campo de pdf_options admitido es grayscale. Para cambiar el diseño, modifica el documento de origen antes de subirlo.

¿Por qué el endpoint odp-to-pdf devuelve 400 Bad Request?#

Se devuelve un 400 Bad Request cuando lo subido no es un archivo .odp, cuando el documento está dañado o no es compatible, o cuando el valor de pdf_options no es JSON válido.