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

title: ファイルをダウンロード
description: 1 回のリクエストで General Translation プロジェクトから複数の翻訳済みファイルをダウンロードします。ファイルのダウンロードの API リファレンス。

method: POST
---

1 回のリクエストで複数のソースファイルまたは翻訳済みファイルをダウンロードします。各エントリでは ID でファイルを指定し、ファイルの内容は base64 で返されます。

## 概要 [#overview]

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

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

複数のファイルを一度に取得します。1 つのファイルをダウンロードする場合は、[ファイルをダウンロード](/docs/platform/openapi/reference/files/download)を使用します。

## 仕組み [#how-it-works]

* 1〜100 個のファイル参照を送信します。各参照は個別に解決され、成功した結果がまとめて返されます。
* `locale` のないエントリはソースファイルを返し、`locale` のあるエントリはその翻訳を返します。
* `branchId` がない場合はデフォルトブランチとして解決されます。`versionId` がない場合は、`useLatestAvailableVersion` が設定されていない限り、ブランチ先頭のバージョンが使用されます。
* ファイルの内容は `data` フィールドに base64 エンコードされて返されます。`fileName` はソースファイルにのみ含まれ、`locale` は翻訳済みファイルにのみ含まれます。

## リクエスト [#request]

### ヘッダー

| ヘッダー              | 説明                          | 必須  |
| ----------------- | --------------------------- | --- |
| `x-gt-api-key`    | プロジェクトまたは組織の API キー。        | はい  |
| `x-gt-project-id` | プロジェクト ID。組織キーを使用する場合は必須です。 | いいえ |

### ボディ

**コンテンツタイプ** `application/json`

ボディは、1〜100 個のファイル参照を含む JSON 配列です。各要素には次のフィールドがあります。

| フィールド                       | 説明                                              | 型         | 任意  | デフォルト        |
| --------------------------- | ----------------------------------------------- | --------- | --- | ------------ |
| `fileId`                    | 安定したファイル識別子。空にすることはできません。                       | `string`  | いいえ | —            |
| `branchId`                  | 読み取り元のブランチ。                                     | `string`  | はい  | デフォルトブランチ    |
| `versionId`                 | ダウンロードする特定のバージョン。                               | `string`  | はい  | ブランチの先頭バージョン |
| `locale`                    | ダウンロードするロケール。省略するとソースファイルをダウンロードします。            | `string`  | はい  | —            |
| `useLatestAvailableVersion` | リクエストしたバージョンが見つからない場合は、利用可能な最新バージョンにフォールバックします。 | `boolean` | はい  | `false`      |

## レスポンス [#response]

**ステータス** `200 OK`

```json title="Response"
{
  "files": [
    {
      "id": "sf_...",
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileName": "en/common.json",
      "data": "eyJoZWxsbyI6ICJIZWxsbyJ9",
      "metadata": {},
      "fileFormat": "JSON"
    },
    {
      "id": "tf_...",
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "locale": "es",
      "data": "eyJoZWxsbyI6ICJIb2xhIn0=",
      "metadata": {},
      "fileFormat": "JSON"
    }
  ],
  "count": 2
}
```

## エラー [#errors]

| ステータス | 原因                                     |
| ----- | -------------------------------------- |
| `400` | リクエストボディが無効か、エントリに有効な `fileId` がありません。 |
| `401` | API キーが存在しないか、無効です。                    |
| `403` | API キーに `project:files:read` 権限がありません。 |
| `429` | レート制限を超えています。                          |

## 例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/files/download \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '[
    { "fileId": "file_...", "locale": "es" },
    { "fileId": "file_..." }
  ]'
```