# General Translation Platform: Pubblica i file
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/files/publish-files.mdx
---

title: Pubblica i file
description: Contrassegna i file tradotti di un progetto General Translation come pubblicati, in modo che siano pronti per la distribuzione. Riferimento API per la pubblicazione dei file.

method: POST
---

Pubblica o annulla la pubblicazione dei file tradotti sulla CDN di General Translation. Imposta `publish` per ciascun file per controllarne la distribuzione e ottenere un risultato per file e per impostazione regionale.

## Panoramica [#overview]

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

**Permesso** `project:files:write` · **Limite di frequenza** Predefinito (200/min)

Controlla quali traduzioni vengono servite dalla CDN. Il progetto deve avere la CDN abilitata.

## Come funziona [#how-it-works]

* Il progetto deve avere la CDN abilitata. In caso contrario, la richiesta fallisce con `400`.
* Per ogni file, viene aggiornato lo stato di pubblicazione del file sorgente. Ogni traduzione completata di quel file viene quindi pubblicata o ne viene annullata la pubblicazione e la relativa voce della cache CDN viene creata o eliminata.
* Quando `publish` è `true` e i dati di una traduzione sono mancanti o troppo grandi per essere pubblicati, quella impostazione regionale viene segnalata come non riuscita. Anche un file troppo grande già pubblicato in precedenza vede annullata la pubblicazione.
* Quando `publish` è `false`, le traduzioni vedono annullata la pubblicazione e dalla cache CDN.
* L'elaborazione avviene per file e per impostazione regionale, quindi la risposta contiene un risultato per ogni traduzione su cui è stata eseguita un'azione. Un file sorgente non trovato viene segnalato come risultato non riuscito, invece di far fallire l'intera richiesta.

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                    | Obbligatorio |
| ----------------- | ------------------------------------------------------------------------------ | ------------ |
| `x-gt-api-key`    | Chiave API del progetto o dell'Organization.                               | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si utilizza una chiave di organizzazione. | No           |

### Corpo

**Tipo di contenuto** `application/json`

| Campo             | Descrizione                                                                          | Tipo       | Facoltativo | Predefinito |
| ----------------- | ------------------------------------------------------------------------------------ | ---------- | ----------- | ----------- |
| [`files`](#files) | Array di file da pubblicare o annullare la pubblicazione; non può essere vuoto. | `object[]` | No          | —           |

#### `files` [#files]

**Tipo** `object[]` · **Obbligatorio**

Ogni elemento identifica un file e lo stato di pubblicazione desiderato:

| Campo       | Descrizione                                                    | Tipo      | Facoltativo | Predefinito        |
| ----------- | -------------------------------------------------------------- | --------- | ----------- | ------------------ |
| `fileId`    | Identificatore stabile del file.                               | `string`  | No          | —                  |
| `versionId` | Identificatore della versione di questo contenuto.             | `string`  | No          | —                  |
| `publish`   | `true` per pubblicare, `false` per annullare la pubblicazione. | `boolean` | No          | —                  |
| `branchId`  | Branch a cui è associato il file.                              | `string`  | Sì          | Branch predefinito |

## Risposta [#response]

**Stato** `200 OK`

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

## Errori [#errors]

| Stato | Causa                                                                           |
| ----- | ------------------------------------------------------------------------------- |
| `400` | Corpo della richiesta non valido oppure il CDN non è abilitato per il progetto. |
| `401` | Chiave API mancante o non valida.                                               |
| `403` | La chiave API non dispone di `project:files:write`.                             |
| `429` | Limite di richieste superato.                                                   |

## Esempio [#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
      }
    ]
  }'
```