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

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

method: POST
---

Возвращает ветку проекта по умолчанию и все ветки, которые вы запрашиваете по имени. Используйте это, чтобы сопоставить имена веток с идентификаторами перед выполнением других операций с файлами.

## Обзор [#overview]

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

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

Получить ветки проекта. Чтобы создать ветку, используйте [Создать ветку](/docs/platform/openapi/reference/project/create-branch).

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

* Ветка по умолчанию возвращается всегда, а если у проекта её нет — `null`.
* `branchNames` фильтрует возвращаемый список `branches`. Если он пуст, именованные ветки не возвращаются.
* Для каждой ветки возвращаются её `id` и `name`.

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

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

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

### Тело

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

| Поле          | Описание                | Тип        | Необязательно | По умолчанию |
| ------------- | ----------------------- | ---------- | ------------- | ------------ |
| `branchNames` | Имена веток для поиска. | `string[]` | Да            | `[]`         |

## Ответ [#response]

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

```json title="Response"
{
  "branches": [
    { "id": "br_...", "name": "feature-x" }
  ],
  "defaultBranch": { "id": "br_...", "name": "main" }
}
```

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

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

## Пример [#example]

```bash
curl -X POST https://api2.gtx.dev/v2/project/branches/info \
  -H "x-gt-api-key: gtx-api-..." \
  -H "Content-Type: application/json" \
  -d '{
    "branchNames": ["feature-x"]
  }'
```