Vai al contenuto
API v1 · Contratto stabile

CREATA PER IL TUO PROSSIMO PROGETTO

Conversione file. Parte del tuo prodotto.

Porta la conversione nella tua applicazione con lo stesso contratto v1 usato dai nostri SDK e strumenti per sviluppatori. Inizia nel sandbox e porta lo stesso flusso in produzione.

Da un file a un’attività completata

Fornisci un file

Un approccio coerente alla conversione di documenti, immagini e contenuti multimediali.

Scegli la conversione

Input, impostazioni di conversione e risultati chiari, dalla richiesta all’output.

Usa il risultato

Esempi eseguibili e il riferimento API sono disponibili nella documentazione per sviluppatori.

PDF → DOCXUpload diretto · impostazioni per coppia · job asincroni · download del risultato
# Esempio API v1 basato sul contratto. Le impostazioni specifiche della coppia sono validate dallo schema delle capacità.
# 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.

Esempio API v1 basato sul contratto. Le impostazioni specifiche della coppia sono validate dallo schema delle capacità.

Aiutaci a dare forma a ciò che viene dopo

Raccontaci i tuoi formati, i volumi e le esigenze di integrazione. Ci piacerebbe sapere cosa stai costruendo.