---
seo_title: Démarrage rapide de l'API de conversion | EnConvert
meta_desc: Convertissez votre premier fichier en 3 étapes : clé API, puis POST /v1/convert/url-to-pdf en cURL ou Python. Exemples Node.js et upload JSON vers XML inclus.
keywords: tutoriel api conversion de fichiers, comment convertir un fichier avec une api, exemple curl url vers pdf, convertir url en pdf en python, exemple api json vers xml, obtenir une clé api de conversion, uploader un fichier via api rest, convertir un fichier avec node.js
---

# 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](https://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

```bash
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 :

```json
{
  "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

```bash
curl -X POST https://api.enconvert.com/v1/convert/json-to-xml \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@data.json" \
  -F "direct_download=false"
```

### Réponse

```json
{
  "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 :

```python
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 :


```javascript
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](https://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 "file=@data.json"` 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](/fr/docs/authentication.md) 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](/fr/docs/endpoints.md) liste toutes les routes que vous pouvez appeler et les paramètres qu'elles partagent.
- [Tâches synchrones et asynchrones](/fr/docs/concepts/sync-and-async.md) explique quand une requête renvoie le résultat en ligne et quand elle vous remet une tâche à interroger.