---
seo_title: API Excel vers PDF : convertir XLSX et XLS en PDF | EnConvert
meta_desc: Convertissez Excel en PDF par API REST. POST /v1/convert/excel-to-pdf transforme .xlsx et .xls en PDF haute fidélité grâce au rendu LibreOffice.
keywords: api excel vers pdf, xlsx en pdf api, convertir xlsx en pdf api, xls en pdf api rest, tableur en pdf api, api conversion excel pdf, xlsx en pdf python, excel en pdf node js
---

# API Excel vers PDF

L'API Excel vers PDF convertit les feuilles de calcul Microsoft Excel (`.xlsx`, `.xls`) en PDF via `POST /v1/convert/excel-to-pdf`, en s'appuyant sur le moteur de rendu haute fidélité de LibreOffice. La mise en forme, les polices et la mise en page propres à la feuille de calcul sont préservées dans le PDF de sortie. La réponse contient les octets bruts du PDF par défaut, ou des métadonnées JSON avec une URL de téléchargement présignée si `direct_download=false`.

---

## Endpoint

```
POST /v1/convert/excel-to-pdf
```

**Content-Type :** `multipart/form-data`

**Entrée acceptée :** fichiers `.xlsx or .xls`

**Format de sortie :** `.pdf` (`application/pdf`)

---

## Authentification

Nécessite soit une clé API privée, soit un token JWT issu d'une clé publique.

```
X-API-Key: sk_your_private_key
```

Ou :

```
Authorization: Bearer <jwt_token>
```

---

## Paramètres de requête

| Paramètre | Type | Requis | Défaut | Description |
|-----------|------|----------|---------|-------------|
| `file` | file | Oui | -- | Le fichier `.xlsx or .xls` à convertir. |
| `output_filename` | `string` | Non | Nom du fichier d'entrée | Nom de fichier de sortie personnalisé. L'extension `.pdf` est ajoutée automatiquement. |
| `direct_download` | `boolean` | Non | `true` | Si `true`, renvoie les octets bruts du PDF. Si `false`, renvoie des métadonnées JSON avec une URL de téléchargement présignée. |
| `pdf_options` | `string` | Non | `null` | Chaîne JSON. Seule l'option `grayscale` est prise en charge sur cet endpoint (voir ci-dessous). |

### Options PDF

Pour les convertisseurs de documents basés sur LibreOffice, la mise en page (taille, marges, orientation) est déterminée par les réglages du document lui-même. Le seul champ `pdf_options` pris en compte est :

| Paramètre | Type | Défaut | Description |
|-----------|------|---------|-------------|
| `grayscale` | `boolean` | `false` | Convertit le PDF de sortie en niveaux de gris via un post-traitement Ghostscript. |

<div class="alert alert-info">
<strong>Note :</strong> La taille de page, les marges, l'orientation, l'échelle, les en-têtes et les pieds de page de <code>pdf_options</code> ne s'appliquent pas à cet endpoint. Le PDF de sortie conserve la mise en forme définie dans le document d'origine. Pour modifier la mise en page, modifiez le document source avant de l'envoyer.
</div>

---

## Détails de la conversion

- Utilise **LibreOffice** (via unoserver) pour le rendu des documents côté serveur
- La mise en forme, les polices, la mise en page et les médias intégrés du document sont préservés
- Timeout de conversion : 120 secondes
- La sortie reproduit fidèlement le document tel qu'il apparaîtrait à l'impression depuis LibreOffice

---

## Réponse

### Téléchargement direct (`direct_download=true`, par défaut)

```
HTTP 200 OK
Content-Type: application/pdf
Content-Disposition: inline; filename="document_20260405_123456789.pdf"
```

Renvoie les octets bruts du PDF.

### Réponse avec métadonnées (`direct_download=false`)

```json
{
    "presigned_url": "https://spaces.example.com/...",
    "object_key": "env/files/{project_id}/excel-to-pdf/document_20260405_123456789.pdf",
    "filename": "document_20260405_123456789.pdf",
    "file_size": 67890,
    "conversion_time_seconds": 3.5
}
```

---

## Exemples de code

### Python

```python
import requests

with open("document.xlsx", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/excel-to-pdf",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("document.xlsx", f)}
    )

with open("output.pdf", "wb") as out:
    out.write(response.content)
```

### Node.js

```javascript
const form = new FormData();
form.append("file", fs.createReadStream("document.xlsx"));

const response = await fetch("https://api.enconvert.com/v1/convert/excel-to-pdf", {
    method: "POST",
    headers: { "X-API-Key": "sk_your_private_key" },
    body: form
});

fs.writeFileSync("output.pdf", Buffer.from(await response.arrayBuffer()));
```

### PHP

```php
$ch = curl_init("https://api.enconvert.com/v1/convert/excel-to-pdf");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["X-API-Key: sk_your_private_key"],
    CURLOPT_POSTFIELDS => ["file" => new CURLFile("document.xlsx")]
]);
$pdf = curl_exec($ch);
curl_close($ch);
file_put_contents("output.pdf", $pdf);
```

### Go

```go
body := &bytes.Buffer{}
writer := multipart.NewWriter(body)
part, _ := writer.CreateFormFile("file", "document.xlsx")
file, _ := os.Open("document.xlsx")
io.Copy(part, file)
writer.Close()

req, _ := http.NewRequest("POST", "https://api.enconvert.com/v1/convert/excel-to-pdf", body)
req.Header.Set("Content-Type", writer.FormDataContentType())
req.Header.Set("X-API-Key", "sk_your_private_key")
resp, _ := http.DefaultClient.Do(req)
```

### Avec sortie en niveaux de gris

```python
import requests
import json

with open("document.xlsx", "rb") as f:
    response = requests.post(
        "https://api.enconvert.com/v1/convert/excel-to-pdf",
        headers={"X-API-Key": "sk_your_private_key"},
        files={"file": ("document.xlsx", f)},
        data={"pdf_options": json.dumps({"grayscale": True})}
    )
```

---

## Réponses d'erreur

| Statut | Condition |
|--------|-----------|
| `400 Bad Request` | Le fichier n'est pas un fichier `.xlsx or .xls` |
| `400 Bad Request` | Échec de la conversion du document (fichier corrompu ou non pris en charge) |
| `400 Bad Request` | JSON `pdf_options` invalide |
| `401 Unauthorized` | Clé API ou token JWT manquant ou invalide |
| `402 Payment Required` | Quota mensuel d'ops épuisé |
| `402 Payment Required` | Limite de stockage atteinte |
| `413 Payload Too Large` | Le fichier dépasse la taille maximale autorisée par le plan |
| `500 Internal Server Error` | La conversion a expiré (limite de 120 secondes) |

---

## Limites

| Limite | Valeur |
|-------|-------|
| Taille maximale de fichier | Selon le plan (Founding : 5 MB) |
| Timeout de conversion | 120 secondes |
| Conversions mensuelles | Selon le plan |

## Questions fréquentes

### Comment convertir une feuille de calcul XLSX en PDF avec une API REST ?

Envoyez une requête `multipart/form-data` à `POST /v1/convert/excel-to-pdf` avec votre fichier `.xlsx` ou `.xls` dans le champ `file`, authentifiée via `X-API-Key` ou un JWT Bearer. Par défaut, la réponse contient les octets bruts du PDF avec `Content-Type: application/pdf`.

### La conversion Excel vers PDF préserve-t-elle la mise en forme du tableur ?

Oui. L'endpoint utilise LibreOffice (via unoserver) pour le rendu côté serveur : la mise en forme, les polices, la mise en page et les médias intégrés de la feuille de calcul sont préservés. La sortie reproduit le document tel qu'il apparaîtrait à l'impression depuis LibreOffice.

### Puis-je définir la taille de page, les marges ou l'orientation lors de la conversion Excel vers PDF ?

Non. La mise en page est déterminée par les réglages de la feuille de calcul elle-même, et le seul champ `pdf_options` pris en charge sur cet endpoint est `grayscale`. Pour modifier la mise en page, modifiez le fichier source avant de l'envoyer.

### Pourquoi ma conversion Excel vers PDF a-t-elle échoué ou expiré ?

Un `400 Bad Request` signifie que le fichier n'est pas `.xlsx` ou `.xls`, qu'il est corrompu ou non pris en charge, ou que le JSON `pdf_options` est invalide. Un `500 Internal Server Error` signifie que la conversion a dépassé le timeout de 120 secondes.

### Puis-je obtenir une URL de téléchargement au lieu des octets du PDF ?

Oui. Définissez `direct_download=false` et l'endpoint renvoie des métadonnées JSON comprenant `presigned_url`, `object_key`, `filename`, `file_size` et `conversion_time_seconds`.