Сайт сервиса: https://rubitime.ru
API: https://rubitime.ru/faq/api
Действия
Для сервиса онлайн-записи Rubitime предусмотрены следующие действия:
Получить запись по ID
Получение данных записи по ее ID. Узнать ID записи можно открыв ее на просмотр/редактирование, в заголовке "Запись #47 на 27/11/2024 11:00 до 13:00", - здесь 47 это ID записи.
Получить список записей по ID
То же, что и метод получения одной записи, но только нескольких - ID перечисляются через запятую. Максимальное количество записей: 100.
Получить список записей за день
Позволяет получить список всех записей за определенную дату, например 2024-10-30. Максимальное количество записей: 100.
Получение дат и времени для записи
Позволяет получить свободные и/или занятые даты и время для записи по определенному филиалу, сотруднику и услуге. Узнать ID филиала, сотрудника и услуги можно при просмотре/редактировании сущности (пример ниже в методе "Создание записи"). Параметр "Вернуть даты и время" позволяет вернуть либо даты и время, только занятые или только свободные.
Создание записи
Для создания записи необходимо заполнить обязательные поля: ID филиала, ID сотрудника, ID услуги, Дата и время записи и статус, а так же указать подключение. Остальные поля заполняются по необходимости.
Получить ID филиала/сотрудника/услуги можно открыв сущность на редактирование из строки "Редактировать услугу #8" (ID услуги в данном случае - 8):
Список статусов:
0 - Записан;
1 - На обслуживании;
2 - Завершен;
3 - Ожидание предоплаты;
4 - Отменен;
5 - Ожидает подтверждения;
6 - Добавлено в корзину;
7 - Перенос записи.
Обновление записи
Для обновления записи необходимо обязательно указать ID записи и подключение, остальные поля заполняются по необходимости. ID записи можно получить открыв запись на просмотр из строки "Запись #47 на 28/06/2024 11:00 до 13:00" (ID записи в данном случае - 47):
Удаление записи
Для удаления записи необходимо указать ID записи (см. действие "Обновление записи") и подключение.
Триггеры
В качестве триггеров Rubitime поддерживает следующие события - создание записи, обновление записи и удаление записи.
Чтобы триггер принимал выбранное событие, скопируйте URL после создания первого шага сценария и вставьте его в строку "Вебхук URL" системы Rubitime:
Также в качестве триггера Вы можете использовать и общий модуль Webhook, в этом случае вставьте скопированный URL этого модуля в строку "Вебхук URL" системы Rubitime, а также выберите нужные события в блоке "Отправляемые события".
Подключение
Для создания подключения к Rubitime, в системе Rubitime в разделе "Настройки -> API" нажмите кнопку "Сгенерировать ключ":
Далее в APInita создайте новое подключение, назовите его, например, Rubitime, выберите тип "Custom", укажите ключ запроса "rk", в значение вместо "12345" вставьте полученный ключ из Rubitime, установите галочку "Передавать в запросе" и сохраните:
Используемый формат даты и времени
Сервис Rubitime передает и принимает дату и время в формате "YYYY-MM-DD hh:mm:ss". Часовой пояс соответствует времени МСК (UTC +3).
Например, дата 31 декабря 2020, время 15:30 по МСК записывается в следующем виде:
2020-12-31 15:30:00
Чтобы преобразовать передаваемую из других систем дату и время в формат, принимаемый Rubitime,добавьте Twig фильтр date с форматом |date('d.m.Y H:i') к переменной, содержащей значение даты и времени.
Пример применения фильтра date к условной переменной 's1.body.data.event_time':
{{ s1.body.data.event_time|date('d.m.Y H:i') }}
Если Ваш часовой пояс отличается от МСК, добавьте также Twig фильтр date_modify, прописав в аргументе требуемое смещение. К примеру, для часового пояса МСК+4 (красноярское время) пропишите |date_modify('+4 hours').
Пример условной переменной 's1.body.data.event_time' с применением фильтра date + date_modify:
{{ s1.body.data.event_time|date('d.m.Y H:i')|date_modify('+4 hours') }}
Смещение часового пояса рекомендуется выяснить на практике, выполнив реальный сценарий по передаче данных из другой системы в Rubitime, и посмотрев дату и время созданной записи непосредственно в журнале, так как заранее предсказать все нюансы, возникающие при передаче времени из других систем с учетом их настроек и логики API, бывает затруднительно.
