RTeam Developer API

deplover.rteam.info — портал и API для интеграций с RTeam

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

Все запросы к API требуют персональный ключ, который выдаётся в личном кабинете после входа через Google или через аккаунт RTeam. Передавайте его заголовком:

X-API-Key: rteam_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Либо, если заголовок неудобен (например, тестируете прямо в браузере), query-параметром:

GET /api/me.php?api_key=rteam_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Ключ даёт доступ к API от вашего имени — не публикуйте его в клиентском JS и не коммитьте в открытые репозитории. Скомпрометированный ключ можно перевыпустить в кабинете одной кнопкой.

2. Вход в портал

Способ	Как это работает
Google OAuth 2.0	Стандартный OpenID Connect flow. `index.php` → `google_login.php` → согласие Google → `google_callback.php`, который меняет `code` на токен, читает email и создаёт/находит dev-аккаунт.
Аккаунт RTeam	Логин и пароль сверяются напрямую с `https://rteam.info/users.json` (тот же источник, что использует основная админ-панель сайта).

3. Эндпоинты

Кто я

GET /api/me.php

Возвращает данные владельца ключа.

curl https://deplover.rteam.info/api/me.php \
  -H "X-API-Key: rteam_xxxxx"

{
  "id": "google:dev@example.com",
  "name": "Dev Name",
  "email": "dev@example.com",
  "via": "google",
  "created": 1767200000
}

Пользователь RTeam по логину

GET /api/user.php?login=<login>

Отдаёт нормализованные данные одного пользователя из rteam.info/users.json (роль, есть ли активная PLUS-подписка / золотой билет).

curl "https://deplover.rteam.info/api/user.php?login=Roma_07b" \
  -H "X-API-Key: rteam_xxxxx"

{
  "user": {
    "login": "Roma_07b",
    "role": "Администратор",
    "plus": true,
    "email": null,
    "golden": false
  }
}

Код	Значение
404 `not_found`	Пользователь с таким логином не найден

Поиск / список пользователей

GET /api/users.php?q=&plus=&limit=&offset=

Параметр	Обязателен	Описание
`q`	нет	подстрока для поиска по логину
`plus`	нет	`1` — только с активной PLUS/золотым билетом
`limit`	нет	1–200, по умолчанию 50
`offset`	нет	смещение для пагинации

curl "https://deplover.rteam.info/api/users.php?plus=1&limit=20" \
  -H "X-API-Key: rteam_xxxxx"

{
  "total": 134,
  "limit": 20,
  "offset": 0,
  "users": [
    { "login": "Roma_07b", "role": "Администратор", "plus": true, "email": null, "golden": false },
    { "login": "Petryha",  "role": "Модератор",     "plus": true, "email": null, "golden": true }
  ]
}

4. Общие коды ошибок

HTTP	error	Причина
401	`missing_api_key`	Не передан заголовок/параметр с ключом
401	`invalid_api_key`	Ключ не найден или отозван (перевыпущен)
400	`missing_login`	Не передан обязательный параметр
404	`not_found`	Запрошенный объект не существует

5. Вебхук оплаты (для справки)

Портал поддержки клиентов client.rteam.info принимает уведомления об оплате от платёжного провайдера Platega на POST /payment_webhook.php. Это внутренний эндпоинт (не требует API-ключа deplover — вызывается самой платёжной системой), упомянут здесь для полноты картины интеграций RTeam.

Нужен новый эндпоинт или отдающиеся сейчас данные недостаточны? Опишите задачу в чате поддержки RTeam — мы дорабатываем API под реальные интеграции.