# General Translation Platform: 下载文件
URL: https://generaltranslation.com/zh/docs/platform/openapi/reference/files/download.mdx
---

title: 下载文件
description: 从 General Translation 项目中下载特定区域设置或版本的单个译文文件。下载文件的 API 参考。

method: GET
---

按 ID 下载单个源文件或译文文件。文件内容以 base64 格式返回。

*注意：对于新的集成，建议优先使用 [下载文件](/docs/platform/openapi/reference/files/download-many)。保留此单文件 endpoint 是为了向后兼容。*

## 概览 [#overview]

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

**权限** `project:files:read` · **速率限制** 轻量 (300/分钟) 

获取单个文件。如需在一次调用中下载多个文件，请使用[下载文件](/docs/platform/openapi/reference/files/download-many)。

## 工作方式 [#how-it-works]

* 如果没有 `locale` 查询参数，则返回源文件；如果提供了 `locale`，则返回对应的翻译。
* 如果未提供 `branchId`，则默认解析到默认分支。未提供 `versionId` 时，则使用该分支的最新版本。
* 文件内容会以 base64 编码的形式在 `data` 字段中返回。文件不存在时返回 `404`。

## 请求 [#request]

### 请求头

| 请求头               | 描述               | 必填 |
| ----------------- | ---------------- | -- |
| `x-gt-api-key`    | 项目或组织 API 密钥。    | 是  |
| `x-gt-project-id` | 项目 ID。使用组织密钥时必填。 | 否  |

### 路径参数

| 参数       | 描述             | 类型       | 必填 |
| -------- | -------------- | -------- | -- |
| `fileId` | 用于下载的稳定的文件标识符。 | `string` | 是  |

### 查询参数

| 参数          | 描述                 | 类型       | 可选 | 默认值    |
| ----------- | ------------------ | -------- | -- | ------ |
| `locale`    | 要下载的区域设置。不填则下载源文件。 | `string` | 是  | —      |
| `branchId`  | 要读取的分支。            | `string` | 是  | 默认分支   |
| `versionId` | 要下载的指定版本。          | `string` | 是  | 分支最新版本 |

## 响应 [#response]

**状态** `200 OK`

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

## 错误 [#errors]

| 状态    | 原因                                          |
| ----- | ------------------------------------------- |
| `400` | 缺少 `fileId`，或 `branchId`/`versionId` 不是字符串。 |
| `401` | 缺少 API 密钥，或 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-..."
```