Загрузка...

Управление командой (Team API)

Team API позволяет автоматизировать управление участниками команды: создавать учётные записи сотрудников, приглашать существующих пользователей, менять роли и лимиты расходов — всё по мастер-ключу командного аккаунта.

Базовый путь: https://routerai.ru/api/v1/team

Аутентификация

Используется мастер-ключ команды — тот же тип ключа, что и для управления API-ключами:

  1. Переключитесь в командный аккаунт под администратором команды
  2. Перейдите в Настройки → Мастер-ключи
  3. Создайте мастер-ключ и сохраните его

Важно про доступ:

  • Мастер-ключ должен быть создан в контексте команды. Мастер-ключ личного аккаунта получит 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.