Fournir un fichier
Une approche cohérente pour la conversion de documents, d’images et de médias.
CONÇU POUR VOTRE PROCHAIN PROJET
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.
Une approche cohérente pour la conversion de documents, d’images et de médias.
Des entrées, paramètres de conversion et résultats clairs, de la requête au fichier de sortie.
Des exemples exécutables et la référence de l’API sont disponibles dans la documentation développeur.
# 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.
Parlez-nous de vos formats, volumes et besoins d’intégration. Nous aimerions savoir ce que vous construisez.