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

title: Télécharger un fichier
description: Téléchargez un seul fichier traduit depuis un projet General Translation pour un paramètre régional ou une version. Référence de l’API pour Télécharger un fichier.

method: GET
---

Télécharge un fichier source ou traduit à partir de son ID. Le contenu du fichier est renvoyé en base64.

*Remarque : privilégiez [Télécharger des fichiers](/docs/platform/openapi/reference/files/download-many) pour les nouvelles intégrations. Cet endpoint de fichier unique est conservé pour assurer la rétrocompatibilité.*

## Vue d’ensemble [#overview]

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

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

Récupérez un fichier. Pour télécharger plusieurs fichiers en un seul appel, utilisez [Télécharger des fichiers](/docs/platform/openapi/reference/files/download-many).

## Fonctionnement [#how-it-works]

* Sans paramètre de requête `locale`, le fichier source est renvoyé. Avec `locale`, la traduction correspondante est renvoyée.
* En l’absence de `branchId`, la branche par défaut est utilisée. En l’absence de `versionId`, la version en tête de la branche est utilisée.
* Le contenu du fichier est renvoyé, encodé en base64, dans le champ `data`. Si le fichier est introuvable, `404` est renvoyé.

## Requête [#request]

### En-têtes

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

### Paramètres de chemin d’accès

| Paramètre | Description                                  | Type     | Obligatoire |
| --------- | -------------------------------------------- | -------- | ----------- |
| `fileId`  | Identifiant stable du fichier à télécharger. | `string` | Oui         |

### Paramètres de requête

| Paramètre   | Description                                                                                | Type     | Facultatif | Par défaut                    |
| ----------- | ------------------------------------------------------------------------------------------ | -------- | ---------- | ----------------------------- |
| `locale`    | Paramètre régional à télécharger. Omettez ce paramètre pour télécharger le fichier source. | `string` | Oui        | —                             |
| `branchId`  | Branche à lire.                                                                            | `string` | Oui        | Branche par défaut            |
| `versionId` | Version spécifique à télécharger.                                                          | `string` | Oui        | Version en tête de la branche |

## Réponse [#response]

**État** `200 OK`

```json title="Response"
{
  "data": "eyJoZWxsbyI6ICJIb2xhIn0="
}
```

## Erreurs [#errors]

| État  | Cause                                                                            |
| ----- | -------------------------------------------------------------------------------- |
| `400` | `fileId` manquant, ou `branchId`/`versionId` n’est pas une chaîne de caractères. |
| `401` | Clé API manquante ou invalide.                                                   |
| `403` | La clé API n’a pas l’autorisation `project:files:read`.                          |
| `404` | Fichier introuvable.                                                             |
| `429` | Limite de requêtes dépassée.                                                     |

## Exemple [#example]

```bash
curl -X GET "https://api2.gtx.dev/v2/project/files/download/file_...?locale=es" \
  -H "x-gt-api-key: gtx-api-..."
```