# Démarrage rapide

Effectuez votre premier appel API et téléchargez un fichier Excel.

Documentation officielle: https://img2excel.net/fr/docs/api/getting-started

L’API IMG2Excel convertit les images de tableaux en classeurs Excel modifiables. Nous recommandons l’interface synchrone : envoyez une image, attendez la conversion, puis téléchargez le fichier XLSX via l’URL renvoyée. Les interfaces asynchrones restent disponibles.

| Paramètre | Valeur |
| --- | --- |
| URL de base | `https://img2excel.net` |
| Authentification | `Authorization: Bearer $IMG2EXCEL_API_KEY` |
| Accès à l’API | Pack de crédits Business ou Professionnel |
| Entrée | Une image PNG, JPG ou JPEG, de 4 Mo maximum |
| Sortie | Un fichier `.xlsx` modifiable |

## 1. Configurer votre clé API

Copiez votre clé depuis les [paramètres API](https://img2excel.net/fr/settings/api) et enregistrez-la dans une variable d’environnement côté serveur :

```bash
export IMG2EXCEL_API_KEY="your_api_key"
```

Gardez la clé confidentielle. Ne l’intégrez pas au code exécuté dans le navigateur ni à un dépôt public.

## 2. Envoyer une image de tableau

Choisissez l’interface adaptée à votre image :

| Image | Interface |
| --- | --- |
| Tableau imprimé, capture d’écran ou feuille de calcul numérisée | [Image vers Excel](https://img2excel.net/fr/docs/api/image-to-excel) |
| Tableau, journal ou registre manuscrit | [Écriture manuscrite vers Excel](https://img2excel.net/fr/docs/api/handwriting-to-excel) |

L’exemple ci-dessous envoie un tableau imprimé. Remplacez `table.png` par le chemin de votre image. Pour l’écriture manuscrite, utilisez `/api/v1/handwriting-to-excel`.

```bash
curl --fail-with-body --max-time 330 -i https://img2excel.net/api/v1/image-to-excel \
  -H "Authorization: Bearer $IMG2EXCEL_API_KEY" \
  -H "Idempotency-Key: table-import-001" \
  -F "file=@table.png"
```

Utilisez une nouvelle valeur `Idempotency-Key` pour chaque nouvelle image. Réutilisez-la uniquement pour retenter le même envoi.

La requête synchrone renvoie **200 OK** à la fin de la conversion, avec `result.download_url`. L’URL ci-dessous est un exemple ; utilisez celle de votre réponse.

```json
{
  "id": "job_0123456789abcdef0123456789abcdef",
  "type": "image-to-excel",
  "status": "succeeded",
  "credits_reserved": 1,
  "credits_used": 1,
  "created_at": "2026-10-04T09:00:00.000Z",
  "completed_at": "2026-10-04T09:00:08.000Z",
  "result": {
    "filename": "table_result.xlsx",
    "content_type": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
    "size_bytes": 17330,
    "download_url": "https://signed-storage-url.example/...",
    "download_url_expires_in": 900
  }
}
```

L’interface synchrone attend la fin de la conversion. Réglez le délai d’attente du client HTTP sur 330 secondes. En cas d’expiration de la connexion, réessayez avec la même `Idempotency-Key`. Une nouvelle clé lance une nouvelle conversion.

## 3. Télécharger le fichier Excel

Copiez `result.download_url` depuis la réponse réussie :

```bash
curl --fail --location "PASTE_RESULT_DOWNLOAD_URL_HERE" --output table.xlsx
```

L’URL de téléchargement est valide pendant 15 minutes. Le résultat reste disponible pendant 24 heures après la conversion ; consultez à nouveau la tâche pour obtenir une nouvelle URL pendant cette période. Une conversion échouée ne consomme pas de crédits.

## Conversion asynchrone (facultative)

Pour un traitement en arrière-plan, ajoutez `/jobs` au chemin de conversion. Une nouvelle tâche renvoie `202`, son ID et l’en-tête `Location`. Interrogez cette URL toutes les 2 à 3 secondes jusqu’à `succeeded`, `failed` ou `expired`. Consultez [Tâches et erreurs](https://img2excel.net/fr/docs/api/jobs) pour le script de suivi.

Un échec de conversion synchrone renvoie `422`, `error.code` et `error.message`. Une nouvelle tentative avec la même clé d’idempotence renvoie la tâche initiale. Si elle est encore en cours, la réponse est `202` ; consultez l’URL `Location`. Un résultat expiré renvoie `410`.

## Utiliser un assistant de programmation IA

Cliquez sur **Copier pour l’IA** ci-dessus, puis collez les instructions dans ChatGPT, Claude, Gemini, Cursor ou un autre assistant. Précisez le langage utilisé côté serveur et le type de tableau à convertir : imprimé ou manuscrit. Chaque page d’interface propose aussi la copie et des exemples Python / Node.js.

Consultez la [spécification OpenAPI](https://img2excel.net/api/openapi.json) ou la [documentation API complète](https://img2excel.net/fr/docs/api/text/llms-full.txt) pour la définition complète de l’API.

---

OpenAPI 3.1: https://img2excel.net/api/openapi.json
Documentation API complète: https://img2excel.net/fr/docs/api/text/llms-full.txt