Как выпустить токен API для конструктора сайтов
Сайт, собранный в конструкторе сайтов, получает данные из RentProg по токену: список филиалов, категории транспортных средств и каталог. Токен даёт только чтение этих данных — менять что-либо в RentProg по нему нельзя.
Кому доступно
Токены работают, только если конструктор сайтов входит в тариф компании. Пробный период этот доступ не открывает. Без услуги вне пробного периода панель недоступна для раскрытия, а уже выпущенные токены перестают работать. В пробном периоде панель можно раскрыть, но без услуги внутри отображается сообщение «Конструктор сайтов недоступен в текущем тарифе.».
Создавать и отзывать токены могут пользователи с ролями «Менеджер», «Управляющий филиалом» и «Главный администратор». Остальные пользователи могут просматривать список токенов в пределах доступной им компании или филиала.
Как создать токен
- Откройте профиль компании, вкладка «Интеграции», и раскройте панель с подписью «Конструктор сайтов — токены API».
- Нажмите «Создать токен».
- Введите «Название токена», например имя сайта, и подтвердите создание.
- Скопируйте токен в окне «Токен создан» значком копирования.
- Нажмите «Я скопировал токен».
Важно
Скопируйте токен сейчас — после закрытия окна он не будет показан повторно. RentProg хранит не сам токен, а только его отпечаток и последние четыре символа. Потерянный токен восстановить нельзя: выпустите новый, а старый отзовите.
Токен, выпущенный в панели, имеет уровень «Главная компания»: сайт по нему видит все филиалы группы компаний.
Список токенов
| Столбец | Что показывает |
|---|---|
| Название | Имя, которое вы дали токену |
| Окончание | Последние четыре символа токена |
| Уровень | «Главная компания» или «Филиал» |
| Статус | «Активный» или «Отозван» |
| Создан | Когда выпущен |
| Использован | Когда сайт последний раз обращался по токену |
Как отозвать токен
- Нажмите значок удаления в строке токена.
- Подтвердите в окне «Отозвать токен?» кнопкой «Отозвать».
Отзыв необратим: сайт с этим токеном сразу теряет доступ. Отозванный токен остаётся в списке со статусом «Отозван».
Что сайт получает по токену
Сайт передаёт токен в заголовке Authorization: Bearer rps_… и может запросить:
- филиалы — название, город и число активных транспортных средств;
- категории — классы, которые указаны у активных транспортных средств;
- каталог — активные транспортные средства не из архива, без демонстрационных: название, класс, базовая цена, валюта, год, коробка передач, топливо.
Каталог отдаётся страницами, по умолчанию по 50 записей, не больше 200 за запрос. Ограничение частоты — 60 запросов в минуту на токен.