# General Translation Platform: Obtenir les informations d’un fichier
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/files/file-info.mdx
---

title: Obtenir les informations d’un fichier
description: Consultez les métadonnées du fichier source de General Translation, les versions, les paramètres régionaux et l’état de la traduction. Référence API pour Obtenir les informations d’un fichier.

method: POST
---

Renvoie les métadonnées des fichiers source et des fichiers traduits par référence. Interrogez les fichiers source, les fichiers traduits ou les deux en une seule requête.

## Vue d’ensemble [#overview]

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

**Autorisation** `project:files:read` · **Limite de requêtes** Par défaut (200/min)

Consultez les métadonnées du fichier sans télécharger son contenu. Pour l’avancement de la traduction par paramètre régional d’un fichier donné, utilisez [Obtenir l’état de la traduction](/docs/platform/openapi/reference/files/translation-status).

## Fonctionnement [#how-it-works]

* Fournissez `sourceFiles`, `translatedFiles` ou les deux. Chaque liste est résolue indépendamment et renvoyée dans son propre tableau.
* Seuls les fichiers existants sont renvoyés ; les références sans correspondance sont ignorées au lieu de provoquer une erreur.
* La réponse contient uniquement des métadonnées (paramètres régionaux, formats, horodatages), et non le contenu des fichiers.

## 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é Organization. | Non         |

### Corps

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

| Champ             | Description                                    | Type       | Facultatif | Par défaut |
| ----------------- | ---------------------------------------------- | ---------- | ---------- | ---------- |
| `sourceFiles`     | Références aux fichiers source à rechercher.   | `object[]` | Oui        | —          |
| `translatedFiles` | Références aux fichiers traduits à rechercher. | `object[]` | Oui        | —          |

Chaque élément de `sourceFiles` requiert `fileId`, `versionId` et `branchId`. Chaque élément de `translatedFiles` requiert `fileId`, `versionId`, `branchId` et `locale`. Aucune de ces valeurs ne peut être vide.

## Réponse [#response]

**État** `200 OK`

```json title="Response"
{
  "sourceFiles": [
    {
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileName": "en/common.json",
      "fileFormat": "JSON",
      "dataFormat": "JSON",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "publishedAt": null,
      "locales": ["es", "fr"],
      "sourceLocale": "en"
    }
  ],
  "translatedFiles": [
    {
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileFormat": "JSON",
      "dataFormat": "JSON",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "approvedAt": null,
      "publishedAt": null,
      "completedAt": "2026-01-01T00:00:00.000Z",
      "locale": "es"
    }
  ]
}
```

## Erreurs [#errors]

| État  | Cause                                                             |
| ----- | ----------------------------------------------------------------- |
| `400` | Paramètre de requête de fichier invalide.                         |
| `401` | Clé API manquante ou invalide.                                    |
| `403` | La clé API ne dispose pas de l’autorisation `project:files:read`. |
| `429` | Limite de requêtes dépassée.                                      |

## Exemple [#example]

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