Ir para o conteúdo
API v1 · Contrato estável

CRIADA PARA O SEU PRÓXIMO PROJETO

Conversão de ficheiros. Parte do seu produto.

Integre a conversão na sua aplicação com o mesmo contrato v1 usado pelos nossos SDKs e ferramentas para programadores. Comece no sandbox e leve o mesmo fluxo para produção.

De um ficheiro a uma tarefa concluída

Forneça um ficheiro

Uma abordagem consistente à conversão de documentos, imagens e multimédia.

Escolha a conversão

Entradas, definições de conversão e resultados claros, do pedido ao ficheiro final.

Use o resultado

Exemplos executáveis e a referência da API estão disponíveis na documentação para desenvolvedores.

PDF → DOCXEnvio direto · definições por par · tarefas assíncronas · transferência do resultado
# Exemplo da API v1 baseado no contrato. As definições específicas de cada par são validadas pelo 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.

Exemplo da API v1 baseado no contrato. As definições específicas de cada par são validadas pelo esquema de capacidades.

Ajude a definir o que vem a seguir

Fale-nos dos seus formatos, volume e necessidades de integração. Gostaríamos de saber o que está a construir.