# General Translation Platform: Скачать файл
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/files/download.mdx
---

title: Скачать файл
description: Скачать один переведённый файл из проекта General Translation для локали или версии. Справочник API для метода Download file.

method: GET
---

Скачивает один исходный или переведённый файл по ID. Содержимое файла возвращается в формате base64.

*Примечание: для новых интеграций рекомендуется использовать [Скачать файлы](/docs/platform/openapi/reference/files/download-many). Этот эндпоинт для одного файла сохранён для обратной совместимости.*

## Обзор [#overview]

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

**Разрешение** `project:files:read` · **Ограничение частоты запросов** Низкое (300/min)

Возвращает один файл. Чтобы скачать несколько файлов одним запросом, используйте [Скачать файлы](/docs/platform/openapi/reference/files/download-many).

## Как это работает [#how-it-works]

* Без параметра строки запроса `locale` возвращается исходный файл. При наличии `locale` возвращается соответствующий перевод.
* Если `branchId` не указан, используется ветка по умолчанию. Если `versionId` не указан, используется последняя версия ветки.
* Содержимое файла возвращается в поле `data` в кодировке base64. Если файл не найден, возвращается `404`.

## Запрос [#request]

### Заголовки

| Заголовок         | Описание                                                    | Обязательно |
| ----------------- | ----------------------------------------------------------- | ----------- |
| `x-gt-api-key`    | API-ключ Project или Organization.                          | Да          |
| `x-gt-project-id` | ID проекта. Требуется при использовании ключа Organization. | Нет         |

### Параметры пути

| Параметр | Описание                                       | Тип      | Обязательный |
| -------- | ---------------------------------------------- | -------- | ------------ |
| `fileId` | Постоянный идентификатор файла для скачивания. | `string` | Да           |

### Параметры строки запроса

| Параметр    | Описание                                                            | Тип      | Необязательный | По умолчанию           |
| ----------- | ------------------------------------------------------------------- | -------- | -------------- | ---------------------- |
| `locale`    | Локаль для загрузки. Если не указать, будет загружен исходный файл. | `string` | Да             | —                      |
| `branchId`  | Ветка, из которой выполняется чтение.                               | `string` | Да             | Ветка по умолчанию     |
| `versionId` | Конкретная версия для загрузки.                                     | `string` | Да             | Последняя версия ветки |

## Ответ [#response]

**Статус** `200 OK`

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

## Ошибки [#errors]

| Статус | Причина                                                               |
| ------ | --------------------------------------------------------------------- |
| `400`  | Отсутствует `fileId`, или `branchId`/`versionId` не является строкой. |
| `401`  | Отсутствует или недействителен API-ключ.                              |
| `403`  | У API-ключа нет разрешения `project:files:read`.                      |
| `404`  | Файл не найден.                                                       |
| `429`  | Превышен лимит запросов.                                              |

## Пример [#example]

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