Документация

У системы есть HTTP API — через него работают мобильные приложения и страница онлайн-записи. Тот же интерфейс доступен и вам.

Адрес и формат

Каждый салон живёт на своём поддомене. Запросы идут туда же:

https://<салон>.77crm.ru/appointly_api/api/...

Ответ всегда JSON вида {"status": true, "data": ...}. При ошибке — status: false, код и текст сообщения.

Авторизация

Вход по почте и паролю сотрудника, в ответ приходит пара токенов:

POST /appointly_api/api/auth_business/login_email
Content-Type: application/json

{"email": "you@example.com", "password": "..."}

Дальше access_token передаётся в каждом запросе заголовком Authorization: Bearer <token>. Токен живёт ограниченное время и обновляется по refresh_token.

Роль и права зашиты в токен в момент входа. Если сотруднику поменяли доступ, новые права применятся после перевыпуска токена — то есть после повторного входа.

Публичные методы записи

Работают без авторизации — на них построена страница онлайн-записи:

Метод	Что возвращает
`GET /api/v1/tenants/{салон}/services`	услуги салона
`GET /api/v1/tenants/{салон}/staff`	мастеров, можно по услуге
`GET /api/v1/tenants/{салон}/availability`	свободные слоты на дату
`POST /api/v1/tenants/{салон}/appointments`	создаёт запись

Ограничения

На бесплатном тарифе действует лимит в 30 записей в месяц — он проверяется и при создании записи через API, а не только в приложении. Превышение возвращает ошибку с кодом PLAN_LIMIT_REACHED.

За доступом к остальным методам и вопросами по интеграции пишите на support@77crm.ru.