# General Translation Platform: Recupera informazioni sul file
URL: https://generaltranslation.com/it/docs/platform/openapi/reference/files/file-info.mdx
---

title: Recupera informazioni sul file
description: Esamina i metadati, le versioni, le locales e lo stato di traduzione dei file sorgente di General Translation. Riferimento API per il recupero delle informazioni sul file.

method: POST
---

Restituisce i metadati dei file sorgente e tradotti in base al riferimento. Consente di interrogare i file sorgente, i file tradotti o entrambi con un'unica richiesta.

## Panoramica [#overview]

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

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

Consulta i metadati del file senza scaricarne il contenuto. Per lo stato di avanzamento della traduzione per ogni impostazione regionale di un singolo file, usa [Ottieni lo stato della traduzione](/docs/platform/openapi/reference/files/translation-status).

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

* Specifica `sourceFiles`, `translatedFiles` o entrambi. Ogni elenco viene risolto in modo indipendente e restituito nel proprio array.
* Vengono restituiti solo i file esistenti; i riferimenti senza corrispondenza vengono omessi anziché generare un errore.
* La risposta contiene solo metadati (locales, formati, timestamp), non il contenuto dei file.

## Richiesta [#request]

### Header

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

### Corpo

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

| Campo             | Descrizione                              | Tipo       | Facoltativo | Predefinito |
| ----------------- | ---------------------------------------- | ---------- | ----------- | ----------- |
| `sourceFiles`     | Riferimenti ai file sorgente da cercare. | `object[]` | Sì          | —           |
| `translatedFiles` | Riferimenti ai file tradotti da cercare. | `object[]` | Sì          | —           |

Ogni elemento di `sourceFiles` richiede `fileId`, `versionId` e `branchId`. Ogni elemento di `translatedFiles` richiede `fileId`, `versionId`, `branchId` e `locale`. Nessun valore può essere vuoto.

## Risposta [#response]

**Stato** `200 OK`

```json title="Response"
{
  "sourceFiles": [
    {
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileName": "en/common.json",
      "fileFormat": "JSON",
      "dataFormat": "JSON",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "publishedAt": null,
      "locales": ["es", "fr"],
      "sourceLocale": "en"
    }
  ],
  "translatedFiles": [
    {
      "branchId": "br_...",
      "fileId": "file_...",
      "versionId": "ver_...",
      "fileFormat": "JSON",
      "dataFormat": "JSON",
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z",
      "approvedAt": null,
      "publishedAt": null,
      "completedAt": "2026-01-01T00:00:00.000Z",
      "locale": "es"
    }
  ]
}
```

## Errori [#errors]

| Stato | Causa                                              |
| ----- | -------------------------------------------------- |
| `400` | Query del file non valida.                         |
| `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/files/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "sourceFiles": [
      {
        "fileId": "file_...",
        "versionId": "ver_...",
        "branchId": "br_..."
      }
    ]
  }'
```