Открытое API и интеграции для салона красоты

API для клиентов, услуг и записей

В Homade есть открытое API v1. Сейчас в нём три метода: GET /api/v1/services отдаёт список услуг, GET /api/v1/clients — клиентов салона, POST /api/v1/bookings создаёт запись с услугой, мастером, временем, именем и телефоном клиента. Запросы подписываются ключом в заголовке Authorization: Bearer. Ключ создаётся в разделе «Интеграции», показывается один раз и отзывается там же.

API подходит салонам, у которых уже есть собственный сайт с нестандартной формой записи, бот в мессенджере или портал франшизы, и им нужно, чтобы запись попадала в то же расписание, которое видит администратор в Homade.

Интеграция с сайтом, ботом и приложением

Для типового сайта хватает встраиваемого виджета, разработчик не нужен. Через API можно сделать свою форму: например, экран бронирования внутри приложения сети. Запись через API проходит те же проверки расписания и пересечений, что и публичная страница записи. Если время уже занято, API вернёт ошибку 409, и форма должна предложить клиенту другое время. Созданная запись сразу появляется в общем календаре Homade.

Чего в API пока нет

• Чтения и изменения существующих записей: для записей есть только создание.
• Отдельного метода для мастеров и свободных окон.
• Отправки событий на вебхуки. Адрес вебхука можно сохранить в кабинете заранее, но события пока не отправляются.
• Интеграции с IP-телефонией: звонки в Homade не попадают.

Для каких салонов нужен тариф с API

API нужен не каждому: одиночному мастеру или небольшому салону обычно достаточно встроенного виджета и стандартной онлайн-записи. Тариф с API оправдан для сетей с собственной IT-инфраструктурой и бизнесов, которым нужно связать Homade с внешним сайтом, ботом или приложением. API работает на тарифах «Бизнес», «Про» и «Сеть»; на «Соло» и «Старт» его нет.