# General Translation Platform: Genera il contesto
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/context/generate-context.mdx
---

title: Genera il contesto
description: Genera i termini del Glossario e le istruzioni di traduzione del progetto General Translation dai file sorgente. Riferimento API per la generazione del contesto di traduzione.

method: POST
---

Mette in coda un job in background che genera il contesto di traduzione a livello di progetto — termini del Glossario e istruzioni di traduzione — dai file sorgente a cui fai riferimento. Facoltativamente, genera glossari per singola impostazione regionale per le impostazioni regionali di destinazione.

## Panoramica [#overview]

```http
POST https://api2.gtx.dev/v2/project/setup/generate
```

**Permesso** `project:context:write` · **Limite di richieste** Medio (120/min)

Genera il contesto che guiderà le traduzioni future. Per monitorare il job risultante, usa [Ottieni lo stato della generazione del contesto](/docs/platform/openapi/reference/context/context-status) o [Ottieni lo stato del job di traduzione](/docs/platform/openapi/reference/translation/job-status).

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

* Le impostazioni regionali di destinazione che usano lo stesso dialetto dell'impostazione regionale predefinita del progetto vengono ignorate.
* A meno che `force` non sia `true`, la generazione viene ignorata quando il progetto ha già un contesto e nessuna impostazione regionale di destinazione richiesta richiede un glossario. In questo caso, la risposta è `{ "status": "completed" }` e non viene accodato alcun job.
* In caso contrario, viene accodato un job per la generazione del contesto e il relativo ID viene restituito con `status: "queued"`. Quando vengono fornite impostazioni regionali di destinazione, vengono aggiornate anche le `locales` correnti del progetto.

## Richiesta [#request]

### Header

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

### Body

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

| Campo             | Descrizione                                                                                                  | Tipo       | Facoltativo | Predefinito |
| ----------------- | ------------------------------------------------------------------------------------------------------------ | ---------- | ----------- | ----------- |
| [`files`](#files) | File sorgente da cui generare il contesto; non può essere vuoto.                                             | `object[]` | No          | —           |
| `locales`         | Impostazioni regionali di destinazione per cui generare glossari per ciascuna impostazione regionale.       | `string[]` | Sì          | —           |
| `force`           | Rigenera il contesto anche se esiste già.                                                                    | `boolean`  | Sì          | `false`     |

#### `files` [#files]

**Tipo** `object[]` · **Obbligatorio**

Ogni elemento fa riferimento a un file sorgente:

| Campo       | Descrizione                                            | Tipo     | Facoltativo | Predefinito |
| ----------- | ------------------------------------------------------ | -------- | ----------- | ----------- |
| `fileId`    | Identificatore stabile del file; non può essere vuoto. | `string` | No          | —           |
| `versionId` | Identificatore della versione; non può essere vuoto.   | `string` | No          | —           |
| `branchId`  | Branch a cui è associato il file.                      | `string` | Sì          | —           |

## Risposta [#response]

**Stato** `200 OK`

```json title="Response"
{
  "setupJobId": "job_...",
  "status": "queued"
}
```

Quando non è necessaria alcuna generazione, la risposta è invece:

```json title="Response"
{
  "status": "completed"
}
```

## Errori [#errors]

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

## Esempio [#example]

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