# General Translation Platform: ファイルをダウンロード
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/files/download.mdx
---

title: ファイルをダウンロード
description: 指定したロケールまたはバージョン向けに、General Translation プロジェクトから単一の翻訳済みファイルをダウンロードします。「ファイルをダウンロード」の API リファレンスです。

method: GET
---

ID を指定して、ソースファイルまたは翻訳済みファイルを 1 つダウンロードします。ファイルの内容は base64 で返されます。

*注: 新しい統合では [ファイルをダウンロード](/docs/platform/openapi/reference/files/download-many) の利用を推奨します。この単一ファイル用エンドポイントは、後方互換性のために維持されています。*

## 概要 [#overview]

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

**権限** `project:files:read` · **レート制限** 軽め (300/分)

1 つのファイルを取得します。1 回の呼び出しで複数のファイルをダウンロードするには、[複数のファイルをダウンロード](/docs/platform/openapi/reference/files/download-many)を使用します。

## 動作の仕組み [#how-it-works]

* `locale` クエリパラメータがない場合はソースファイルが返され、`locale` がある場合は対応する翻訳が返されます。
* `branchId` がない場合はデフォルトブランチが使用されます。`versionId` がない場合はブランチヘッドバージョンが使用されます。
* ファイルの内容は `data` フィールドに base64 エンコードされて返されます。ファイルが見つからない場合は `404` が返されます。

## リクエスト [#request]

### ヘッダー

| ヘッダー              | 説明                                   | 必須  |
| ----------------- | ------------------------------------ | --- |
| `x-gt-api-key`    | プロジェクトまたはOrganizationのAPIキー。         | はい  |
| `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-..."
```