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

# Получить права и лимиты текущего бота

> Возвращает идентификатор бота, согласованные серверы и scopes, действующие права с учётом trust factor и фактические лимиты текущей политики.

Возвращает идентификатор бота, согласованные серверы и scopes, действующие права с учётом trust factor и фактические лимиты текущей политики. Дополнительный scope не требуется. Новые права выдаются только после отдельного согласования. Наличие функции в API не расширяет доступ существующего токена.

## Доступ

Достаточно действующего токена бота.

**Authorization** `string` *required*

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

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

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

**access\_revision** `integer` *required*

Текущая версия согласованного доступа бота.

**approved\_scopes** `string[] | null` *required*

Scopes, согласованные и выданные текущему боту.

**effective\_scopes** `string[] | null` *required*

Действующие scopes с учётом текущего trust factor и поддерживаемых функций API.

**environment** `string` *required*

Среда действия токена: live или test.

**id** `string` *required*

Идентификатор записи.

**limits** `object` *required*

Фактические лимиты текущей политики: общий лимит разработчика, лимит бота и лимиты классов запросов.

**Поля**

**bot** `object` *required*

Лимит текущего бота.

**Поля**

**burst** `integer` *required*

Максимальное число запросов, доступное сразу при полном запасе квоты.

**refill\_interval\_ms** `integer` *required*

Интервал восстановления одной единицы квоты в миллисекундах.

**requests\_per\_second** `number` *required*

Устойчивая скорость восстановления квоты, запросов в секунду. Одновременно действует предел burst.

Формат `double`.

**developer** `object` *required*

Лимит запросов всего разработчика, общий для его ботов.

**Поля**

**burst** `integer` *required*

Максимальное число запросов, доступное сразу при полном запасе квоты.

**refill\_interval\_ms** `integer` *required*

Интервал восстановления одной единицы квоты в миллисекундах.

**requests\_per\_second** `number` *required*

Устойчивая скорость восстановления квоты, запросов в секунду. Одновременно действует предел burst.

Формат `double`.

**operations** `object` *required*

Лимиты отдельных классов запросов. применяются одновременно с общими лимитами.

**name** `string` *required*

Название текущего бота из согласованной заявки.

**server\_ids** `string[] | null` *required*

Идентификаторы серверов. Для текущего бота возвращаются только согласованные серверы.

**server\_numbers** `integer[] | null` *required*

Номера серверов в том же порядке, что и server\_ids.

**trust\_factor** `integer` *required*

Текущий trust factor разработчика, от 0 до 100.

## Ошибки

| 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/me'
```

```json HTTP 200, сокращённый ответ theme={null}
{
  "id": "01910000-0000-7000-8000-000000000001",
  "environment": "test",
  "trust_factor": 50,
  "approved_scopes": [
    "roster:read"
  ],
  "effective_scopes": [
    "roster:read"
  ],
  "server_ids": [
    "01910000-0000-7000-8000-000000000001"
  ],
  "server_numbers": [
    102
  ]
}
```


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