# General Translation Platform: Получить статус задачи перевода
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/translation/job-status.mdx
---

title: Получить статус задачи перевода
description: Получение статуса поставленной в очередь задачи перевода в General Translation. Справка по API для метода «Получить статус задачи перевода».

method: POST
---

Возвращает статус одной или нескольких поставленных в очередь задач по ID. Используйте этот метод, чтобы опрашивать задачи, созданные с помощью [Поставить переводы в очередь](/docs/platform/openapi/reference/translation/queue) или [Сгенерировать контекст перевода](/docs/platform/openapi/reference/context/generate-context).

## Обзор [#overview]

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

**Разрешение** `project:files:read` · **Лимит запросов** По умолчанию (200/мин)

Проверяйте прогресс фоновых задач одним запросом.

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

* Передайте один или несколько ID задач. Поиск задач выполняется в рамках аутентифицированного проекта.
* Исходный status каждой задачи нормализуется: задачи со status `pending` и `queued` возвращают `queued`; задачи со status `processing` и `retrying` возвращают `processing`; задачи со status `failed` возвращают `failed` с `error.message`; задачи со status `completed` возвращают `completed`.
* Возвращаются только задачи, соответствующие переданным ID. ID, которым не соответствует ни одна задача, не включаются в массив ответа; если ни один из переданных ID не соответствует задаче, запрос возвращает `200` с пустым массивом.

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

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

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

### Тело

**Тип содержимого** `application/json`

| Поле     | Описание                                                                                  | Тип        | Необязательное | По умолчанию |
| -------- | ----------------------------------------------------------------------------------------- | ---------- | -------------- | ------------ |
| `jobIds` | Идентификаторы задач для поиска; требуется как минимум один, пустые значения недопустимы. | `string[]` | Нет            | —            |

## Ответ [#response]

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

Ответ — 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..."]
  }'
```