# General Translation Platform: Scarica un file
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/files/download.mdx
---

title: Scarica un file
description: Scarica un singolo file tradotto da un progetto General Translation per un'impostazione regionale o una versione. Riferimento API per Scarica un file.

method: GET
---

Scarica un file sorgente o tradotto tramite ID. Il contenuto del file viene restituito in formato base64.

*Nota: per le nuove integrazioni, usa preferibilmente [Scarica file](/docs/platform/openapi/reference/files/download-many). Questo endpoint per file singolo è mantenuto per retrocompatibilità.*

## Panoramica [#overview]

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

**Permesso** `project:files:read` · **Limite di richieste** Basso (300/min)

Recupera un file. Per scaricare più file in una sola chiamata, usa [Scarica file](/docs/platform/openapi/reference/files/download-many).

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

* Senza un parametro di query `locale`, viene restituito il file sorgente. Con `locale`, viene restituita la traduzione corrispondente.
* Se `branchId` non è specificato, viene usato il branch predefinito. Se `versionId` non è specificato, viene usata la versione head del branch.
* Il contenuto del file viene restituito nel campo `data`, codificato in base64. Se il file non esiste, viene restituito `404`.

## Richiesta [#request]

### Intestazioni

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

### Parametri del percorso

| Parametro | Descrizione                                   | Tipo     | Obbligatorio |
| --------- | --------------------------------------------- | -------- | ------------ |
| `fileId`  | Identificatore stabile del file da scaricare. | `string` | Sì           |

### Parametri di query

| Parametro   | Descrizione                                                                       | Tipo     | Facoltativo | Predefinito                 |
| ----------- | --------------------------------------------------------------------------------- | -------- | ----------- | --------------------------- |
| `locale`    | Impostazione regionale da scaricare. Se omesso, viene scaricato il file sorgente. | `string` | Sì          | —                           |
| `branchId`  | Branch da cui leggere.                                                            | `string` | Sì          | Branch predefinito          |
| `versionId` | Versione specifica da scaricare.                                                  | `string` | Sì          | Versione head del branch    |

## Risposta [#response]

**Stato** `200 OK`

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

## Errori [#errors]

| Stato | Causa                                                              |
| ----- | ------------------------------------------------------------------ |
| `400` | `fileId` mancante oppure `branchId`/`versionId` non è una stringa. |
| `401` | Chiave API mancante o non valida.                                  |
| `403` | La chiave API non ha `project:files:read`.                         |
| `404` | File non trovato.                                                  |
| `429` | Limite di richieste superato.                                      |

## Esempio [#example]

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