# General Translation Platform: Descargar archivo
URL: https://generaltranslation.com/es/docs/platform/openapi/reference/files/download.mdx
---

title: Descargar archivo
description: Descarga un único archivo traducido de un Project de General Translation para una configuración regional o una versión. Referencia de la API para Descargar archivo.

method: GET
---

Descarga un archivo fuente o traducido por ID. El contenido del archivo se devuelve en base64.

*Nota: para nuevas integraciones, usa preferentemente [Descargar archivos](/docs/platform/openapi/reference/files/download-many). Este endpoint de un solo archivo se mantiene por compatibilidad con versiones anteriores.*

## Descripción general [#overview]

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

**Permiso** `project:files:read` · **Límite de velocidad** Bajo (300/min)

Obtiene un archivo. Para descargar varios archivos en una sola llamada, usa [Descargar archivos](/docs/platform/openapi/reference/files/download-many).

## Cómo funciona [#how-it-works]

* Sin un parámetro de consulta `locale`, se devuelve el archivo fuente. Con `locale`, se devuelve la traducción correspondiente.
* Si no se especifica `branchId`, se usa la rama predeterminada. Si no se especifica `versionId`, se usa la versión más reciente de la rama.
* El contenido del archivo se devuelve codificado en base64 en el campo `data`. Si no se encuentra el archivo, devuelve `404`.

## Solicitud [#request]

### Cabeceras

| Cabecera          | Descripción                                                          | Obligatorio |
| ----------------- | -------------------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | Clave de API de Project o Organization.                              | Sí          |
| `x-gt-project-id` | ID del Project. Obligatorio cuando se usa una clave de Organization. | No          |

### Parámetros de la ruta

| Parámetro | Descripción                                              | Tipo     | Obligatorio |
| --------- | -------------------------------------------------------- | -------- | ----------- |
| `fileId`  | Identificador estable del archivo que se va a descargar. | `string` | Sí          |

### Parámetros de consulta

| Parámetro   | Descripción                                                                                      | Tipo     | Opcional | Predeterminado                  |
| ----------- | ------------------------------------------------------------------------------------------------ | -------- | -------- | ------------------------------- |
| `locale`    | Configuración regional que se descargará. Omite este parámetro para descargar el archivo fuente. | `string` | Sí       | —                               |
| `branchId`  | Rama desde la que se leerá.                                                                      | `string` | Sí       | Rama predeterminada             |
| `versionId` | Versión específica que se descargará.                                                            | `string` | Sí       | Versión más reciente de la rama |

## Respuesta [#response]

**Estado** `200 OK`

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

## Errores [#errors]

| Estado | Causa                                                       |
| ------ | ----------------------------------------------------------- |
| `400`  | Falta `fileId` o `branchId`/`versionId` no es una `string`. |
| `401`  | Falta la clave de API o no es válida.                            |
| `403`  | La clave de API no incluye `project:files:read`.                 |
| `404`  | No se encontró el archivo.                                  |
| `429`  | Se excedió el límite de solicitudes.                        |

## Ejemplo [#example]

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