# General Translation Platform: Ottieni lo stato del job di traduzione
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/translation/job-status.mdx
---

title: Ottieni lo stato del job di traduzione
description: Recupera lo stato di un job di traduzione in coda in General Translation. Riferimento API per ottenere lo stato del job di traduzione.

method: POST
---

Restituisce lo stato di uno o più job in coda tramite ID. Usalo per monitorare periodicamente i job creati da [Accoda traduzioni](/docs/platform/openapi/reference/translation/queue) o [Genera il contesto di traduzione](/docs/platform/openapi/reference/context/generate-context).

## Panoramica [#overview]

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

**Permesso** `project:files:read` · **Limite di richieste** Predefinito (200/min)

Controlla lo stato di avanzamento dei job in background con una sola richiesta.

## Come funziona [#how-it-works]

* Invia uno o più ID di job. I job vengono cercati nel Project autenticato.
* Lo status grezzo di ciascun job viene normalizzato: i job `pending` e `queued` riportano `queued`; i job `processing` e `retrying` riportano `processing`; i job `failed` riportano `failed` con un `error.message`; i job `completed` riportano `completed`.
* Vengono restituiti solo i job corrispondenti agli ID forniti. Gli ID che non corrispondono ad alcun job vengono omessi dall'array di risposta; se una richiesta contiene ID che non corrispondono a nulla, restituisce `200` con un array vuoto.

## Richiesta [#request]

### Header

| Header            | Descrizione                                                                    | Obbligatorio |
| ----------------- | ------------------------------------------------------------------------------ | ------------ |
| `x-gt-api-key`    | Chiave API del Project o dell'Organization.                                | Sì           |
| `x-gt-project-id` | ID progetto. Obbligatorio quando si utilizza una chiave dell'Organization. | No           |

### Corpo

**Tipo di contenuto** `application/json`

| Campo    | Descrizione                                                                     | Tipo       | Facoltativo | Predefinito |
| -------- | ------------------------------------------------------------------------------- | ---------- | ----------- | ----------- |
| `jobIds` | ID dei job da recuperare; almeno uno è obbligatorio e nessuno può essere vuoto. | `string[]` | No          | —           |

## Risposta [#response]

**Stato** `200 OK`

La risposta è un array JSON con un elemento per ogni job risolto:

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

## Errori [#errors]

| Stato | Causa                                                    |
| ----- | -------------------------------------------------------- |
| `400` | Corpo della richiesta non valido o array `jobIds` vuoto. |
| `401` | chiave API mancante o non valida.                        |
| `403` | La chiave API non dispone di `project:files:read`.       |
| `429` | Limite di richieste superato.                            |

## Esempio [#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..."]
  }'
```