Developer API

API для разработчиков

Интегрируйте онлайн-запись в ваш сайт или приложение

Возможности

REST API

Интерактивная документация OpenAPI: все маршруты, схемы запросов и ответов.

Открыть Swagger

Webhook-уведомления

Скоро

Подписка на события записей и статусов — в разработке.

Виджет записи

Встройте запись на свой сайт: код виджета в настройках кабинета.

Настройки → embed

Быстрый старт

1. Получить доступ по email

Запросите ссылку для входа на почту (до 5 запросов с одного IP за 10 минут; не более 3 запросов на один адрес за 15 минут). После перехода по ссылке вы в кабинете с сессией.

curl -sS -X POST https://samozapis.online/api/v1/auth/magic-link \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com"}'

2. Публичные данные компании

Пример: услуги по публичному slug (замените salon1 на свой).

curl -sS "https://samozapis.online/api/v1/company/salon1/services"

Открыть SwaggerПолный список эндпоинтов с авторизацией — в интерактивной документации.

Публичные эндпоинты

Метод	Путь	Описание
GET	/api/v1/company/{slug}/services	Список услуг компании
GET	/api/v1/company/{slug}/staff	Список сотрудники
GET	/api/v1/company/{slug}/staff/{id}/slots	Свободные слоты сотрудника
POST	/api/v1/book	Создание записи (публичный CORS)
GET	/api/v1/plans	Тарифы и лимиты
POST	/api/v1/widget/click	Событие клика по виджету

Вопросы по API: support@samozapis.online