Управление командой (Team API)
Team API позволяет автоматизировать управление участниками команды: создавать учётные записи сотрудников, приглашать существующих пользователей, менять роли и лимиты расходов — всё по мастер-ключу командного аккаунта.
Базовый путь: https://routerai.ru/api/v1/team
Аутентификация
Используется мастер-ключ команды — тот же тип ключа, что и для управления API-ключами:
- Переключитесь в командный аккаунт под администратором команды
- Перейдите в Настройки → Мастер-ключи
- Создайте мастер-ключ и сохраните его
Важно про доступ:
- Мастер-ключ должен быть создан в контексте команды. Мастер-ключ личного аккаунта получит
403. - Управлять командой может только ключ, созданный администратором команды. Мастер-ключ, созданный обычным участником (роль
member), предназначен для управления его собственными API-ключами и к Team API не допускается — вернётся403. Если участника позже понизили с админа доmember, его ранее созданные ключи тоже перестают управлять командой.
Роли участников
| Роль | Что доступно в командном аккаунте |
|---|---|
admin |
Всё: участники и приглашения, финансы команды (баланс, пополнение, история платежей, способы оплаты, автопополнение, уведомления о балансе), API-ключи и логи всех участников, настройки команды |
member |
Свои API-ключи, свои запросы, логи и статистика (включая стоимость собственных запросов), Telegram-боты команды |
Обычный участник не видит баланс команды и раздел «Финансы» и не может пополнять счёт. Если участнику нужно знать остаток или пополнить баланс — это делает администратор команды. Владелец команды (создатель) — всегда администратор, и только он может переводить средства между личным балансом и балансом команды.
curl -H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
https://routerai.ru/api/v1/team
Создание учётной записи сотрудника
Создание учётных записей через API включается для команды по обращению в поддержку: напишите, какой команде оно нужно и сколько сотрудников вы планируете завести. Пока возможность не включена, метод отвечает 403 с "code": "member_provisioning_disabled". Приглашения (следующий раздел) доступны всем командам без обращения.
POST /api/v1/team/members создаёт учётную запись и сразу добавляет её в команду — сотруднику не нужно регистрироваться и принимать приглашение. Email при этом считается неподтверждённым: при первом входе в личный кабинет сотруднику придёт письмо со ссылкой подтверждения, и без перехода по ней вход в кабинет невозможен.
curl -X POST https://routerai.ru/api/v1/team/members \
-H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{
"email": "employee@example.com",
"role": "member",
"monthly_spending_limit": 5000,
"spending_limit_period": "month"
}'
Лимит расходов действует в календарном окне spending_limit_period: day (с 00:00), week (с понедельника) или month (с 1-го числа, по умолчанию). При превышении запросы участника блокируются до начала следующего окна.
Ответ содержит одноразовую ссылку установки пароля (действует 6 часов):
{
"data": {
"id": 42,
"user_id": 1001,
"email": "employee@example.com",
"role": "member",
"active": true,
"is_owner": false,
"monthly_spending_limit": "5000.0",
"spending_limit_period": "month",
"monthly_spending": "0.0",
"period_spending": "0.0",
"email_confirmed": false,
"created_at": "2026-07-07T12:00:00.000Z"
},
"password_setup_url": "https://routerai.ru/users/password/edit?reset_password_token=..."
}
Варианты выдачи доступа:
| Параметры | Результат |
|---|---|
| (по умолчанию) | В ответе password_setup_url — доставьте сотруднику сами |
"send_email": true |
Плюс письмо со ссылкой установки пароля от платформы |
"password": "..." |
Пароль задан сразу, ссылки нет |
"password" + "send_email": true |
Письмо с логином и паролем открытым текстом (учитывайте риски) |
Во всех вариантах email остаётся неподтверждённым (email_confirmed: false в ответах API) до перехода сотрудника по ссылке из письма подтверждения — оно отправляется автоматически при первой попытке входа в личный кабинет или после установки пароля по ссылке.
Если сотрудник вместо этого войдёт через ВКонтакте или Яндекс с тем же адресом, адрес подтвердится этим входом, а заданный через API пароль и ссылка установки пароля перестанут действовать: аккаунт принадлежит владельцу адреса. Участие в команде, роль и лимит сохраняются; пароль сотрудник при необходимости задаёт сам в настройках аккаунта.
Если email уже зарегистрирован, вернётся 409 — используйте приглашения.
Число создаваемых учётных записей ограничено: до 200 в час и 500 в сутки на команду. При превышении вернётся 429 с "code": "rate_limit_exceeded" и заголовком Retry-After — числом секунд, через которое запрос можно повторить. Если вам нужно больше, напишите в поддержку.
Приглашение существующего пользователя
POST /api/v1/team/invitations создаёт приглашение, которое пользователь принимает под своим аккаунтом (email должен совпадать). Действует 7 дней.
curl -X POST https://routerai.ru/api/v1/team/invitations \
-H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com", "role": "member", "send_email": true}'
В ответе будет invite_url — ссылка принятия; без send_email: true письмо не отправляется, доставьте ссылку сами.
Команда может создать до 30 приглашений в час и 50 в сутки (вместе с приглашениями из личного кабинета). При превышении вернётся 429 с заголовком Retry-After.
До первого пополнения баланса команда может отправить десять приглашений, а человек — создать одну команду. Ограничение снимается первым пополнением баланса команды или её владельца (перевод с другого аккаунта и бонусы пополнением не считаются). Запрос сверх доступного получает 403 с "code": "first_payment_required".
Управление участниками
# Список активных участников
curl -H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
https://routerai.ru/api/v1/team/members
# Смена роли и лимита (0 — без лимита)
curl -X PATCH https://routerai.ru/api/v1/team/members/42 \
-H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{"role": "admin", "monthly_spending_limit": 0}'
# Недельный лимит 1000 ₽ (окно с понедельника; также day и month)
curl -X PATCH https://routerai.ru/api/v1/team/members/42 \
-H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{"monthly_spending_limit": 1000, "spending_limit_period": "week"}'
# Удаление из команды (мягкое — членство деактивируется)
curl -X DELETE https://routerai.ru/api/v1/team/members/42 \
-H "Authorization: Bearer YOUR_TEAM_MASTER_KEY"
# Возврат деактивированного участника
curl -X PATCH https://routerai.ru/api/v1/team/members/42 \
-H "Authorization: Bearer YOUR_TEAM_MASTER_KEY" \
-H "Content-Type: application/json" \
-d '{"active": true}'
Ограничения:
- Владельца команды нельзя понизить или удалить. Лимит расходов владельцу меняет только он сам: мастер-ключом, который создал владелец, или ключом уровня команды; ключ другого администратора получит
422 - Последнего активного администратора нельзя понизить или удалить
- API-ключи удалённого участника не удаляются: запросы с ними получают
403, а после возврата участника ключи снова работают. Администратор видит такие ключи в разделе «Ключи» (фильтр «Бывшие участники») и может отключить или удалить их
Полное описание эндпоинтов — в справочнике API.