Aller au contenu
API v1 · Contrat stable

CONÇU POUR VOTRE PROCHAIN PROJET

La conversion de fichiers. Intégrée à votre produit.

Intégrez la conversion à votre application avec le même contrat v1 que nos SDK et outils développeur. Commencez dans le bac à sable, puis passez le même workflow en production.

D’un fichier à une tâche terminée

Fournir un fichier

Une approche cohérente pour la conversion de documents, d’images et de médias.

Choisir la conversion

Des entrées, paramètres de conversion et résultats clairs, de la requête au fichier de sortie.

Utiliser le résultat

Des exemples exécutables et la référence de l’API sont disponibles dans la documentation développeur.

PDF → DOCXEnvoi direct · paramètres par paire · tâches asynchrones · téléchargement du résultat
# Exemple API v1 fondé sur le contrat. Les paramètres propres à chaque paire sont validés par le schéma de capacités.
# 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.

Exemple API v1 fondé sur le contrat. Les paramètres propres à chaque paire sont validés par le schéma de capacités.

Aidez-nous à façonner la suite

Parlez-nous de vos formats, volumes et besoins d’intégration. Nous aimerions savoir ce que vous construisez.