Convertica API

Por qué Convertica API

Inicio rápido

1. Emite una clave en tu panel de control

Ve a tu panel de claves de API y crea una clave con nombre. La clave completa se muestra una vez — cópiala de inmediato.

2. Realiza una solicitud

Ejemplo con curl — convertir un PDF a Word:

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -o output.docx

Ejemplo en Python

import requests
r = requests.post(
    "https://convertica.net/api/v1/pdf-to-word/",
    headers={"Authorization": "Bearer cvk_live_xxxxxxxxxxxxxxxx"},
    files={"pdf_file": open("input.pdf", "rb")},
)
with open("output.docx", "wb") as f:
    f.write(r.content)

Ejemplo de Node.js

import fs from "node:fs";
import { request } from "undici";
const form = new FormData();
form.set("pdf_file", new Blob([fs.readFileSync("input.pdf")]), "input.pdf");
const r = await request("https://convertica.net/api/v1/pdf-to-word/", {
  method: "POST",
  headers: { Authorization: "Bearer cvk_live_xxxxxxxxxxxxxxxx" },
  body: form,
});
fs.writeFileSync("output.docx", Buffer.from(await r.body.arrayBuffer()));

Autenticación

Envía tu clave de API como un token Bearer en el encabezado Authorization. Las claves están vinculadas a tu suscripción: revócalas y cámbialas en cualquier momento desde el panel.

• Hasta 10 claves activas por cuenta, con ámbito opcional con nombre
• Prefijo mostrado en el panel para facilitar la identificación (la clave completa se muestra solo al crearla)
• Cuota mensual por clave vinculada al nivel de suscripción: el contador se reinicia el día 1
• Almacenada con hash; si una clave se filtra, revócala y emite una nueva en segundos

Webhooks asíncronos

Los trabajos grandes devuelven un ID de tarea y se ejecutan en segundo plano. Puedes consultar el endpoint de la tarea o establecer una URL de devolución de llamada y dejar que Convertica envíe el resultado.

curl -X POST https://convertica.net/api/v1/pdf-to-word/ \
  -H "Authorization: Bearer cvk_live_xxxxxxxxxxxxxxxx" \
  -F "[email protected]" \
  -F "callback_url=https://yourapp.example/convertica-hook"

Los payloads de los webhooks están firmados con HMAC-SHA256 usando el secreto que se muestra en tu panel. Verifica el encabezado X-Convertica-Signature antes de confiar en el cuerpo.

Límites y limitación de velocidad

Lo que obtienes

• Más de 30 endpoints de conversión: PDF↔Word, Excel, PPT, JPG, PNG, HTML, EPUB, Markdown
• Edición de PDF: fusionar, dividir, rotar, marcar agua, firmar, comprimir, recortar, aplanar
• Imagen: optimizar, convertir, HEIC→JPG/PNG
• Modos síncrono (archivos pequeños) y asíncrono (archivos grandes)
• Callbacks de webhook firmados con HMAC opcionales para resultados asíncronos
• Documentación OpenAPI 3
• Mediana inferior a 200 ms, edge en la UE
• Mismo backend que convertica.net — probado en batalla

Preguntas frecuentes