# General Translation Platform: Publier des fichiers
URL: https://generaltranslation.com/fr/docs/platform/openapi/reference/files/publish-files.mdx
---

title: Publier des fichiers
description: Marquez les fichiers traduits d’un Project General Translation comme publiés pour qu’ils soient prêts pour la livraison. Référence de l’API pour la publication de fichiers.

method: POST
---

Publie ou dépublie des fichiers traduits sur le CDN de General Translation. Définissez `publish` pour chaque fichier afin de contrôler la livraison, et recevez un résultat pour chaque fichier et chaque paramètre régional.

## Vue d’ensemble [#overview]

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

**Permission** `project:files:write` · **Limite de débit** Par défaut (200/min)

Contrôlez quelles traductions sont diffusées par le CDN. Le Project doit avoir le CDN activé.

## Fonctionnement [#how-it-works]

* Le Project doit avoir le CDN activé. Sinon, la requête échoue avec `400`.
* Pour chaque fichier, l’état de publication du fichier source est mis à jour. Chaque traduction terminée de ce fichier est ensuite publiée ou dépubliée, et son entrée de cache CDN est créée ou supprimée.
* Lorsque `publish` vaut `true` et que les données d’une traduction sont absentes ou trop volumineuses pour être publiées, ce paramètre régional est signalé comme ayant échoué. Un fichier trop volumineux qui avait déjà été publié est également dépublié.
* Lorsque `publish` vaut `false`, les traductions sont dépubliées et supprimées du cache CDN.
* Le traitement s’effectue par fichier et par paramètre régional ; la réponse contient donc une entrée de résultat pour chaque traduction traitée. Un fichier source introuvable est signalé comme un résultat en échec au lieu de faire échouer l’ensemble de la requête.

## 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         |

### Body

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

| Champ             | Description                                                          | Type       | Facultatif | Par défaut |
| ----------------- | -------------------------------------------------------------------- | ---------- | ---------- | ---------- |
| [`files`](#files) | Liste des fichiers à publier ou à dépublier ; ne peut pas être vide. | `object[]` | Non        | —          |

#### `files` [#files]

**Type** `object[]` · **Obligatoire**

Chaque élément identifie un fichier et l’état de publication souhaité :

| Champ       | Description                                  | Type      | Facultatif | Par défaut         |
| ----------- | -------------------------------------------- | --------- | ---------- | ------------------ |
| `fileId`    | Identifiant stable du fichier.               | `string`  | Non        | —                  |
| `versionId` | Identifiant de version de ce contenu.        | `string`  | Non        | —                  |
| `publish`   | `true` pour publier, `false` pour dépublier. | `boolean` | Non        | —                  |
| `branchId`  | Branche à laquelle le fichier est associé.   | `string`  | Oui        | Branche par défaut |

## Réponse [#response]

**État** `200 OK`

```json title="Response"
{
  "results": [
    {
      "fileId": "file_...",
      "versionId": "ver_...",
      "locale": "es",
      "branchId": "br_...",
      "success": true
    }
  ]
}
```

## Erreurs [#errors]

| État  | Cause                                                                  |
| ----- | ---------------------------------------------------------------------- |
| `400` | Corps de requête invalide, ou le CDN n’est pas activé pour le Project. |
| `401` | Clé API manquante ou invalide.                                         |
| `403` | La clé API ne possède pas l’autorisation `project:files:write`.        |
| `429` | Limite de requêtes dépassée.                                           |

## Exemple [#example]

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