Saltar al contenido
API v1 · Contrato estable

CREADA PARA TU PRÓXIMO DESARROLLO

Conversión de archivos. Parte de tu producto.

Integra la conversión en tu aplicación con el mismo contrato v1 que usan nuestros SDK y herramientas para desarrolladores. Empieza en el sandbox y lleva el mismo flujo a producción.

De un archivo a una tarea terminada

Proporciona un archivo

Un enfoque coherente para convertir documentos, imágenes y medios.

Elige la conversión

Entradas, ajustes de conversión y resultados claros, desde la solicitud hasta la salida.

Usa el resultado

Los ejemplos ejecutables y la referencia de la API están disponibles en la documentación para desarrolladores.

PDF → DOCXCarga directa · ajustes por par · trabajos asíncronos · descarga del resultado
# Ejemplo de API v1 basado en el contrato. Los ajustes de cada par se validan con el esquema de capacidades.
# Local bytes always bypass the API process: create an owned File, upload to its signed URL, then submit the File ID.
API="https://sandbox.api.converterhq.io/v1"
FILE_JSON=$(curl -fsS "$API/files"   -H "Authorization: Bearer $CONVERTERHQ_API_KEY"   -H "Content-Type: application/json"   -d '{"filename":"input.pdf","content_type":"application/octet-stream","retention_seconds":3600}')
FILE_ID=$(printf '%s' "$FILE_JSON" | python3 -c 'import json,sys; print(json.load(sys.stdin)["id"])')
UPLOAD_URL=$(printf '%s' "$FILE_JSON" | python3 -c 'import json,sys; print(json.load(sys.stdin)["upload"]["url"])')
curl -fsS -X PUT "$UPLOAD_URL" --upload-file "input.pdf"
curl -fsS -X POST "$API/files/$FILE_ID/complete"   -H "Authorization: Bearer $CONVERTERHQ_API_KEY"   -H "Content-Type: application/json" -d '{}'

curl -fsS "$API/jobs"   -H "Authorization: Bearer $CONVERTERHQ_API_KEY"   -H "Content-Type: application/json"   -H "Idempotency-Key: example-pdf-docx-001"   -d '{"tasks":{"convert":{"operation":"convert","input":{"file_id":"'"$FILE_ID"'"},"options":{"input_format":"pdf","output_format":"docx","settings":{}}}}}'

# Official SDK convert helpers perform the same Files → signed storage → Jobs transport.

Ejemplo de API v1 basado en el contrato. Los ajustes de cada par se validan con el esquema de capacidades.

Ayuda a dar forma a lo que viene

Cuéntanos sobre tus formatos, volumen y necesidades de integración. Nos gustaría saber qué estás construyendo.