API и токены доступа
API нужен, когда мастерская перестаёт умещаться в один кабинет: свой сайт с заявками, собственная аналитика, обмен с 1С или интеграция, которой нет в списке.
Токен
Токен доступа генерируется в кабинете, в карточке сотрудника. Он выдаётся от имени этого сотрудника и наследует его права: токен приёмщика не прочитает отчёт о прибыли.
Токен — это пароль. Не храните его в коде фронтенда, в публичном репозитории и в переписке. Если токен утёк, перевыпустите его в карточке сотрудника — старый перестанет работать.
Адрес
Запросы идут на https://api.remboard.ru/v2. Токен передаётся в заголовке авторизации, ответы — JSON.
Что обычно автоматизируют
- Заявки с сайта — форма на сайте создаёт клиента и заказ в Remboard.
- Статусы наружу — свой личный кабинет клиента или бот, отдающий статус ремонта.
- Аналитика — выгрузка заказов и оплат в свою отчётность или BI.
- Склад — обмен остатками с учётной системой.
Документация
Описание методов присылаем по запросу: напишите на hello@remboard.ru с почты аккаунта и коротко опишите задачу — так мы сразу пришлём нужную часть, а не весь справочник.
Если интеграция не ваша задача
Значительную часть сценариев закрывают готовые интеграции и ссылка отслеживания — до написания кода стоит проверить, нет ли нужного уже в кабинете.