# General Translation Platform: Télécharger des fichiers
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/files/download-many.mdx
---

title: Télécharger des fichiers
description: Téléchargez plusieurs fichiers traduits d’un projet General Translation en une seule requête. Référence de l’API pour le téléchargement de fichiers.

method: POST
---

Télécharge plusieurs fichiers sources ou traduits en une seule requête. Chaque entrée désigne un fichier par son ID, et le contenu du fichier est renvoyé en base64.

## Vue d’ensemble [#overview]

```http
POST https://api2.gtx.dev/v2/project/files/download
```

**Autorisation** `project:files:read` · **Limite de requêtes** Faible (300/min)

Récupérez plusieurs fichiers à la fois. Pour télécharger un seul fichier, utilisez [Télécharger un fichier](/docs/platform/openapi/reference/files/download).

## Fonctionnement [#how-it-works]

* Envoyez de 1 à 100 références de fichiers. Chacune est résolue indépendamment, puis les résultats obtenus avec succès sont renvoyés ensemble.
* Une entrée sans `locale` renvoie le fichier source ; une entrée avec `locale` renvoie la traduction correspondante.
* En l’absence de `branchId`, la branche par défaut est utilisée. En l’absence de `versionId`, la version HEAD de la branche est utilisée, sauf si `useLatestAvailableVersion` est défini.
* Le contenu du fichier est renvoyé encodé en base64 dans le champ `data`. `fileName` n’est présent que sur les fichiers source, et `locale` n’est présent que sur les fichiers traduits.

## Requête [#request]

### En-têtes

| En-tête           | Description                                                               | Obligatoire |
| ----------------- | ------------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clé API du projet ou de l’organisation.                                   | Oui         |
| `x-gt-project-id` | ID du projet. Obligatoire lors de l’utilisation d’une clé d’organisation. | Non         |

### Corps

**Type de contenu** `application/json`

Le corps est un tableau JSON de 1 à 100 références de fichier. Chaque élément comporte les champs suivants :

| Champ                       | Description                                                                      | Type      | Facultatif | Valeur par défaut          |
| --------------------------- | -------------------------------------------------------------------------------- | --------- | ---------- | -------------------------- |
| `fileId`                    | Identifiant de fichier stable ; ne peut pas être vide.                           | `string`  | Non        | —                          |
| `branchId`                  | Branche à partir de laquelle lire.                                               | `string`  | Oui        | Branche par défaut         |
| `versionId`                 | Version spécifique à télécharger.                                                | `string`  | Oui        | Version en tête de branche |
| `locale`                    | Paramètre régional à télécharger. Omettez-le pour télécharger le fichier source. | `string`  | Oui        | —                          |
| `useLatestAvailableVersion` | Revient à la dernière version disponible si la version demandée est introuvable. | `boolean` | Oui        | `false`                    |

## Réponse [#response]

**État** `200 OK`

```json title="Response"
{
  "files": [
    {
      "id": "sf_...",
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileName": "en/common.json",
      "data": "eyJoZWxsbyI6ICJIZWxsbyJ9",
      "metadata": {},
      "fileFormat": "JSON"
    },
    {
      "id": "tf_...",
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "locale": "es",
      "data": "eyJoZWxsbyI6ICJIb2xhIn0=",
      "metadata": {},
      "fileFormat": "JSON"
    }
  ],
  "count": 2
}
```

## Erreurs [#errors]

| État  | Cause                                                                           |
| ----- | ------------------------------------------------------------------------------- |
| `400` | Corps de la requête invalide, ou une entrée ne contient pas de `fileId` valide. |
| `401` | Clé API manquante ou invalide.                                                  |
| `403` | La clé API ne dispose pas de `project:files:read`.                              |
| `429` | Limite de requêtes dépassée.                                                    |

## Exemple [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/files/download \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '[
    { "fileId": "file_...", "locale": "es" },
    { "fileId": "file_..." }
  ]'
```