API Documentation
Exécuter dans le bac à sable

Démarrage rapide de l'API de conversion de fichiers#

Ce tutoriel de démarrage rapide vous guide à travers votre première requête de conversion de fichiers avec l'API EnConvert, en utilisant /v1/convert/url-to-pdf pour capturer une page web sous forme de PDF. En trois étapes, vous créez un compte, générez une clé API privée, puis envoyez une requête avec cURL, Python ou JavaScript. Un exemple d'upload de fichier en multipart/form-data pour JSON vers XML est également fourni. Les conversions réussies renvoient un presigned_url permettant de télécharger le fichier converti, ainsi que des métadonnées de stockage et de durée.

Démarrage en 3 étapes#

  1. Créez un compte -- Créez un compte sur enconvert.com pour obtenir votre clé API.
  2. Récupérez votre clé API -- Accédez au tableau de bord et générez une clé privée (sk_...). Copiez-la et conservez-la en lieu sûr.
  3. Effectuez votre première requête -- Utilisez les exemples ci-dessous pour convertir un fichier ou une URL.

Exemple : convertir une URL en PDF#

Utilisez l'endpoint /v1/convert/url-to-pdf pour capturer n'importe quelle page web sous forme de document PDF.

cURL#

curl -X POST https://api.enconvert.com/v1/convert/url-to-pdf \
  -H "X-API-Key: YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "direct_download": false}'

Réponse#

Une conversion réussie renvoie l'URL de téléchargement, le chemin de stockage et les métadonnées :

{
  "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...",
  "object_key": "live/files/12345/url-to-pdf/example_20250202_120530123.pdf",
  "filename": "example_20250202_120530123.pdf",
  "file_size": 45678,
  "conversion_time_seconds": 3.21
}
  • presigned_url -- Une URL temporaire et téléchargeable pour le fichier converti.
  • object_key -- Le chemin de stockage du fichier (par exemple, live/files/12345/url-to-pdf/...).
  • filename -- Le nom de fichier généré.
  • file_size -- La taille du fichier converti, en octets.
  • conversion_time_seconds -- La durée de la conversion.

Exemple : convertir un fichier (JSON vers XML)#

Envoyez un fichier à convertir en utilisant multipart/form-data.

cURL#

curl -X POST https://api.enconvert.com/v1/convert/json-to-xml \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "direct_download=false"

Réponse#

{
  "presigned_url": "https://econverter.nyc3.cdn.digitaloceanspaces.com/...",
  "object_key": "live/files/12345/json-to-xml/data_20250202_120530123.xml",
  "filename": "data_20250202_120530123.xml",
  "file_size": 1024,
  "conversion_time_seconds": 0.45
}

Exemple Python#

Utilisez la bibliothèque requests pour convertir une URL en PDF :

import requests

response = requests.post(
    "https://api.enconvert.com/v1/convert/url-to-pdf",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"url": "https://example.com"}
)

result = response.json()
pdf = requests.get(result["presigned_url"]).content

with open("output.pdf", "wb") as f:
    f.write(pdf)

Exemple JavaScript (Node.js)#

Utilisez l'API fetch intégrée (Node.js 18+) ou n'importe quel client HTTP :

const fs = require("fs");

const formData = new FormData();
formData.append("file", new Blob([fs.readFileSync("input.json")]), "input.json");
formData.append("direct_download", "true");

const response = await fetch("https://api.enconvert.com/v1/convert/json-to-xml", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_API_KEY" },
  body: formData,
});

const buffer = Buffer.from(await response.arrayBuffer());
fs.writeFileSync("output.xml", buffer);

Questions fréquentes#

Comment obtenir une clé API pour l'API de conversion de fichiers EnConvert ?#

Créez un compte sur enconvert.com, puis accédez au tableau de bord et générez une clé privée (sk_...). Copiez-la et conservez-la en lieu sûr. Vous l'envoyez à chaque requête dans l'en-tête X-API-Key.

Comment convertir une URL en PDF avec cURL ?#

Envoyez une requête POST à https://api.enconvert.com/v1/convert/url-to-pdf avec votre clé dans l'en-tête X-API-Key et un corps JSON tel que {"url": "https://example.com", "direct_download": false}. La réponse est du JSON ; téléchargez le PDF via la presigned_url qu'elle contient. Si vous mettez plutôt direct_download à true, les octets du PDF reviennent dans le corps de la réponse et --output output.pdf enregistre le fichier directement.

Comment envoyer un fichier à convertir avec l'API REST ?#

Envoyez le fichier en multipart/form-data, par exemple -F "[email protected]" avec cURL vers /v1/convert/json-to-xml. L'exemple Node.js fait de même avec FormData et l'API fetch intégrée (Node.js 18+).

Que contient une réponse de conversion réussie ?#

La réponse JSON inclut presigned_url (une URL temporaire et téléchargeable pour le fichier converti), object_key (le chemin de stockage), filename, file_size en octets, et conversion_time_seconds.

Puis-je convertir une URL en PDF en Python ?#

Oui. Utilisez la bibliothèque requests pour envoyer une requête POST à https://api.enconvert.com/v1/convert/url-to-pdf avec l'en-tête X-API-Key et un corps JSON contenant url, puis lisez presigned_url dans la réponse JSON et téléchargez le fichier.

Étapes suivantes#

  • Authentification couvre les clés privées, les clés publiques avec JWT, et la façon de vérifier les identifiants que vous venez de créer.
  • Points de terminaison liste toutes les routes que vous pouvez appeler et les paramètres qu'elles partagent.
  • Tâches synchrones et asynchrones explique quand une requête renvoie le résultat en ligne et quand elle vous remet une tâche à interroger.
← Introduction Authentication →