API para desarrolladores

Acceso programático a conversiones en servidor de Converty.

La API v1 usa la misma canalización de conversión que la app web. Necesitas una clave API emitida para tu proyecto.

Autenticación

Envía tu clave API en cada solicitud:

Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY

Endpoints

URL base: https://api.example.com

GET /v1 — Metadatos de API (sin clave requerida)
POST /v1/convert/document — PDF, Word, Excel, …
POST /v1/convert/audio — audio · video · image · archive · ebook · 3d
GET /progress/:jobId — Flujo Server-Sent Events
GET /download/:jobId?token=… — Descarga firmada
POST /import/url — Obtener archivo remoto (cuerpo JSON { "url": "…" })

Categorías: document · audio · video · image · archive · ebook · 3d

Flujo típico

POST formulario multipart a /v1/convert/{category} con file, from, to y options JSON.
Recibe { jobId, estimatedSeconds }.
Suscríbete a GET /progress/{jobId} (SSE) para el estado en vivo.
Descarga desde la URL firmada en el evento complete.

curl -X POST "https://api.example.com/v1/convert/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "from=pdf" \
  -F "to=docx" \
  -F 'options={}'

Límites

Se aplican límites de tasa estándar por IP. Los archivos deben coincidir con pares de formatos compatibles. Consulta el registro de convertidores para valores from/to válidos.

¿Necesitas límites más altos o una clave dedicada? Contáctanos.