# General Translation Platform: 翻訳ジョブのステータスを取得
URL: https://generaltranslation.com/ja/docs/platform/openapi/reference/translation/job-status.mdx
---

title: 翻訳ジョブのステータスを取得
description: General Translation でキューに追加された翻訳ジョブのステータスを取得します。翻訳ジョブのステータス取得に関する API リファレンスです。

method: POST
---

ID を指定して、キューに追加された 1 つ以上のジョブの ステータス を返します。[Queue translations](/docs/platform/openapi/reference/translation/queue) または [Generate translation context](/docs/platform/openapi/reference/context/generate-context) で作成したジョブのポーリングに使用します。

## 概要 [#overview]

```http
POST https://api2.gtx.dev/v2/project/jobs/info
```

**Permission** `project:files:read` · **レート制限** デフォルト (200/分) 

1 回のリクエストでバックグラウンドジョブの進捗を確認します。

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

* 1 つ以上のジョブ ID を送信します。ジョブは認証済みのプロジェクト内で検索されます。
* 各ジョブの元のステータスは正規化されます。pending と queued のジョブは `queued`、processing と retrying のジョブは `processing`、failed のジョブは `error.message` を含む `failed`、completed のジョブは `completed` として返されます。
* 指定した ID に一致するジョブのみが返されます。ジョブに対応しない ID はレスポンス配列から除外されます。どの ID にも一致しないリクエストは、空の配列とともに `200` を返します。

## リクエスト [#request]

### ヘッダー

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

### 本文

**Content type** `application/json`

| フィールド    | 説明                                      | 型          | 任意  | デフォルト |
| -------- | --------------------------------------- | ---------- | --- | ----- |
| `jobIds` | 参照する Job ID。1 つ以上指定する必要があり、空文字は指定できません。 | `string[]` | いいえ | —     |

## レスポンス [#response]

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

レスポンスは、解決済みの各ジョブに対応する1件のエントリを含むJSON配列です。

```json title="Response"
[
  { "status": "completed", "jobId": "job_a..." },
  { "status": "processing", "jobId": "job_b..." },
  {
    "status": "failed",
    "jobId": "job_c...",
    "error": { "message": "Translation failed" }
  }
]
```

## エラー [#errors]

| ステータス | 原因                                     |
| ----- | -------------------------------------- |
| `400` | 無効なリクエストボディ、または空の `jobIds` 配列。         |
| `401` | API キーがないか、無効です。                       |
| `403` | API キーに `project:files:read` 権限がありません。 |
| `429` | レート制限を超えました。                           |

## 例 [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/jobs/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "jobIds": ["job_a...", "job_b..."]
  }'
```