> ## 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.

# Первый запрос к партнёрскому API

> Проверьте токен интеграции, получите разрешённые серверы и запросите страницу состава.

Для первого запроса нужен [токен партнёрского бота](https://docs.arzguard.com/cerberus-crm/authentication.md). Загрузите его из защищённой конфигурации интеграции в переменную окружения `PARTNER_TOKEN`. Примеры ниже используют токен тестового окружения.

**1. Проверьте токен и доступ**

Вызовите [GET /me](https://docs.arzguard.com/cerberus-crm/api/get-me.md). При HTTP `200` проверьте `environment`, `effective_scopes` и `limits`.

```bash cURL theme={null}
export CRM_BASE_URL='https://test.crm.arzguard.com'

curl --fail-with-body --silent --show-error \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  "$CRM_BASE_URL/api/partner/v1/me"
```

**2. Получите номер сервера**

Вызовите [GET /servers](https://docs.arzguard.com/cerberus-crm/api/get-servers.md). Выберите сервер из ответа и сохраните его `number`. Например, `102`.

```bash cURL theme={null}
curl --fail-with-body --silent --show-error \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  "$CRM_BASE_URL/api/partner/v1/servers"
```

**3. Прочитайте состав**

Для [GET /servers/](https://docs.arzguard.com/cerberus-crm/api/get-servers-server-id-roster.md){server_id}[/roster](https://docs.arzguard.com/cerberus-crm/api/get-servers-server-id-roster.md) нужен scope `roster:read`. Подставьте номер сервера бота вместо `102`.

```bash cURL theme={null}
curl --fail-with-body --silent --show-error \
  --header "Authorization: Bearer $PARTNER_TOKEN" \
  "$CRM_BASE_URL/api/partner/v1/servers/102/roster?limit=25"
```

Успешный вызов вернёт массив `members`. Если есть `next_cursor`, передайте его в параметре `cursor` следующего запроса. Чтобы найти конкретную запись по Discord, Telegram, форумному ID или никнейму, используйте [поиск сотрудника](https://docs.arzguard.com/cerberus-crm/api/get-servers-server-id-users-lookup.md).


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