# General Translation Platform: Получение информации о файле
URL: https://generaltranslation.com/ru/docs/platform/openapi/reference/files/file-info.mdx
---

title: Получение информации о файле
description: Просматривайте метаданные исходного файла в General Translation, версии, локали и состояние перевода. Справочник по API для получения информации о файле.

method: POST
---

Возвращает метаданные исходного и переведённых файлов по ссылке. Можно запросить исходные файлы, переведённые файлы или и те, и другие в одном запросе.

## Обзор [#overview]

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

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

Просматривайте метаданные файла без загрузки содержимого. Чтобы узнать прогресс перевода по каждой локали для отдельного файла, используйте [Получить статус перевода](/docs/platform/openapi/reference/files/translation-status).

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

* Укажите `sourceFiles`, `translatedFiles` или оба параметра. Каждый список обрабатывается независимо и возвращается в отдельном массиве.
* Возвращаются только существующие файлы; ссылки, для которых ничего не найдено, просто пропускаются и не вызывают ошибку.
* Ответ содержит только метаданные (локали, форматы, временные метки), а не содержимое файлов.

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

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

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

### Тело

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

| Поле              | Описание                                                    | Тип        | Необязательно | По умолчанию |
| ----------------- | ----------------------------------------------------------- | ---------- | ------------- | ------------ |
| `sourceFiles`     | Ссылки на исходные файлы, по которым выполняется поиск.     | `object[]` | Да            | —            |
| `translatedFiles` | Ссылки на переведённые файлы, по которым выполняется поиск. | `object[]` | Да            | —            |

Каждый элемент `sourceFiles` должен содержать `fileId`, `versionId` и `branchId`. Каждый элемент `translatedFiles` должен содержать `fileId`, `versionId`, `branchId` и `locale`. Ни одно из значений не может быть пустым.

## Ответ [#response]

**Статус** `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"
    }
  ]
}
```

## Ошибки [#errors]

| Статус | Причина                                          |
| ------ | ------------------------------------------------ |
| `400`  | Некорректный запрос к файлу.                     |
| `401`  | Отсутствует API-ключ или он недействителен.      |
| `403`  | У API-ключа нет разрешения `project:files:read`. |
| `429`  | Превышен лимит запросов.                         |

## Пример [#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_..."
      }
    ]
  }'
```