> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arzguard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Получить справочник должностей и ролей

> Возвращает серверные должности и роли CRM для бота с согласованными серверами.

Возвращает серверные должности и роли CRM для бота с согласованными серверами. Справочник содержит коды и названия. Возможность конкретного кадрового действия проверяется отдельно методами подготовки действия.

## Доступ

Достаточно действующего токена бота. Если боту ещё не согласовали серверы, справочник будет пустым.

**Authorization** `string` *required*

Партнёрский Bearer-токен. Подробнее в разделе [«Авторизация»](https://docs.arzguard.com/cerberus-crm/authentication.md).

## Успешный ответ

HTTP `200`. Запрос выполнен успешно.

**directions** `object[] | null` *required*

Направления, относящиеся к возвращённым должностям.

**Поля**

**direction\_id** `string`

Код направления CRM.

**id** `string` *required*

Строковый код должности, роли или направления CRM.

**name** `string` *required*

Название контекста.

**rank** `integer`

Порядок должности в иерархии CRM.

**scope\_kind** `string`

Тип контекста роли или должности.

**positions** `object[] | null` *required*

Серверные должности CRM. Право назначения проверяется отдельно.

**Поля**

**direction\_id** `string`

Код направления CRM.

**id** `string` *required*

Строковый код должности, роли или направления CRM.

**name** `string` *required*

Название контекста.

**rank** `integer`

Порядок должности в иерархии CRM.

**scope\_kind** `string`

Тип контекста роли или должности.

**roles** `object[] | null` *required*

Доступные должности.

**Поля**

**direction\_id** `string`

Код направления CRM.

**id** `string` *required*

Строковый код должности, роли или направления CRM.

**name** `string` *required*

Название контекста.

**rank** `integer`

Порядок должности в иерархии CRM.

**scope\_kind** `string`

Тип контекста роли или должности.

## Ошибки

| HTTP | Значение |
| - | - |
| `400` | Некорректные параметры запроса. |
| `401` | Токен отсутствует, недействителен, отозван или не разрешён для этого IP-адреса. |
| `403` | Недостаточно прав у бота или указанного модератора; сервер или функция не входят в выданный доступ. |
| `422` | Данные не прошли проверку формата или ограничений. Подробности находятся в поле errors. |
| `429` | Превышен лимит запросов. Дождитесь интервала, указанного в заголовке Retry-After. |
| `500` | Внутренняя ошибка сервера. |
| `503` | Сервис временно недоступен. Повторите запрос позднее. |

См. [формат ошибок и правила повторов](https://docs.arzguard.com/cerberus-crm/requests-and-errors.md).

## Пример

В примере использованы условные идентификаторы.

```bash cURL theme={null}
curl --request GET \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  'https://test.crm.arzguard.com/api/partner/v1/catalog'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "directions": [],
  "positions": [],
  "roles": []
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.