Documentation de l’API

Convertissez des fichiers depuis votre propre code : envoyez un fichier, suivez son état, téléchargez le résultat. Trois requêtes et une clé d’API.

Obtenir une clé d’APICommencer
curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Premiers pas

De zéro au premier fichier converti :

  1. Choisissez une offre payante (Starter, Pro ou Business) sur 1-converter.com. Les clés d’API ne sont pas disponibles avec Free.
  2. Créez une clé dans Tableau de bord → Paramètres → Clés d’API et copiez-la : elle ne s’affiche qu’une fois.
  3. Envoyez la clé avec votre premier envoi de fichier, comme indiqué dans la section Authentification.

Authentification

Envoyez votre clé d'API avec chaque requête, dans l'un de ces deux en-têtes :

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Les deux en-têtes sont acceptés et portent la même clé : choisissez celui qui convient le mieux à votre client HTTP.

Ne partagez jamais votre clé d’API et ne la versionnez jamais.

Gardez votre clé d’API en lieu sûr et ne l’exposez jamais dans du code côté client.

URL de base

Toutes les requêtes à l’API se font à cette adresse :

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

Endpoints de l’API

Envoyer et convertir

Envoie un fichier et le convertit dans le format demandé

POST/api/v1/convert/upload

En-têtes de la requête

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Corps de la requête

  • fileLe fichier à convertir (obligatoire)
  • target_formatFormat cible (par exemple 'pdf', 'jpg', 'png') (obligatoire)

Réponse

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Vérifier l’état

Indique où en est une conversion

GET/api/v1/convert/status/:id

Réponse

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Télécharger le résultat

Télécharge le fichier converti

GET/api/v1/convert/download/:id

Limites

Chaque offre payante comprend un nombre mensuel d’appels à l’API, le même que sur la page des tarifs.

OffreAppels API par mois
FreePas de clés d’API
Starter1 000 appels API par mois
Pro10 000 appels API par mois
BusinessAPI illimitée

Au-delà des limites, vous recevez une réponse 429 Too Many Requests.

Codes d’erreur

L’API utilise les codes de statut HTTP standard pour indiquer le succès ou l’échec :

CodeDescription
400 Bad RequestParamètres de requête invalides
401 UnauthorizedClé d’API absente ou invalide
403 ForbiddenDroits insuffisants
404 Not FoundRessource introuvable
429 Too Many RequestsLimite de requêtes dépassée
500 Internal Server ErrorErreur du serveur, réessayez

Exemples de code

Exemples dans plusieurs langages de programmation :

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Python

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

cURL

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"

Besoin d’aide ?

Une requête échoue d’une façon que cette documentation n’explique pas ? Écrivez-nous en joignant la requête et la réponse obtenue.

Contacter le supportGérer les clés d’API