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

Базовый URL

Все примеры в этой документации используют:

https://api.bronjoy.com/api

1. Создайте аккаунт

Если у вас ещё нет бизнес-аккаунта Bronjoy, зарегистрируйте его:

POST https://api.bronjoy.com/api/org/auth/register
Content-Type: application/json

{
  "name": "Jane Smith",
  "email": "[email protected]",
  "password": "secret"
}

Подтвердите код, который придёт на почту, — в ответе вы получите Bearer-токен. Подробности в разделе Аутентификация.

2. Создайте организацию

Пользователь может владеть одной или несколькими организациями либо состоять в них. Создайте организацию:

POST https://api.bronjoy.com/api/org/organizations
Authorization: Bearer your-token
Content-Type: application/json

{
  "business_name": "Downtown Barbershop",
  "slug": "downtown-barbershop"
}

slug — это адрес вашей страницы записи (bronjoy.com/downtown-barbershop), выберите что-то короткое и уникальное. В ответе будет id организации — он понадобится для каждого запроса ниже.

3. Задайте контекст организации

Каждому запросу к /api/org/... нужно знать, с какой организацией вы работаете. Передавайте её в заголовке каждого запроса:

X-Organization-ID: 1

4. Сделайте первый запрос

Проверьте чек-лист настройки:

GET https://api.bronjoy.com/api/org/setup-status
Authorization: Bearer your-token
X-Organization-ID: 1

Или получите список услуг (он будет пустым, пока вы не создадите первую, — см. Настройка организации):

GET https://api.bronjoy.com/api/org/services
Authorization: Bearer your-token
X-Organization-ID: 1

Дальнейшие шаги

• Аутентификация — полные сценарии авторизации для сотрудников и клиентов, а также выпуск токенов API с ограниченными правами
• Настройка организации — полный чек-лист настройки, чтобы бизнес начал принимать записи
• Процесс записи — как клиент записывается от начала до конца
• Интеграция MCP — подключение AI-клиента к вашей организации
• API Reference — все эндпоинты, форматы запросов и ответов