API предварительной записи
API-проводник
Отправляйте запросы к API прямо из документации: получите услуги, посмотрите свободные слоты, создайте тестовую бронь и проверьте чтение, отмену или перенос. Запросы идут в песочницу через публичный тестовый ключ и не попадают в живую очередь.
is_test=true: они не появляются на табло, в живой очереди,
отчётах и дашборде. Тестовые записи автоматически удаляются через сутки.
/api/queue/booking текущего сервера
Здесь появится ответ API…
…
Как это работает
- Получите услуги Нажмите «Загрузить услуги» — проводник подставит доступные ID в подсказки. Если услуги не загрузились, проверьте, включена ли предварительная запись в админке.
-
Выберите метод
Для слотов и создания брони нужны ID услуги, дата и время. Для чтения, отмены
и переноса —
booking_ref, который вернул метод создания. -
Отправьте запрос
Слева формируется запрос с заголовками и телом, справа появляется статус,
время ответа,
X-Request-Idи JSON. Код запроса можно скопировать. -
Проверьте сценарий целиком
Создайте бронь, прочитайте её по
booking_ref, перенесите на другое время и отмените. Все действия остаются в песочнице.
Пример ответа
После создания тестовой брони справа появится статус 201 Created,
время выполнения, X-Request-Id и JSON. Ключ
booking_ref из ответа можно сразу вставить в поле «booking_ref»
и прочитать, перенести или отменить эту запись.
{
"booking_ref": "hXk2m9Qb1sA7cD4e",
"number": "T-014",
"status": "booked",
"scheduled_at": "2026-12-01T11:30:00.000Z",
"scheduled_at_local": "2026-12-01 14:30",
"timezone": "Europe/Moscow",
"service": { "id": 3, "name": "Приём документов", "prefix": "П" },
"is_test": true,
"callable": false,
"created_at": "2026-11-20T12:00:00.000Z"
}
Префикс T- и поле is_test: true говорят, что это
песочница. У запроса с тем же Idempotency-Key ответ будет
201 с заголовком Idempotent-Replayed, но вторая
бронь не создастся. Если в ответе ошибка, формат всегда один:
{"error": "пояснение", "code": "код_ошибки"}.
Безопасность и ограничения
503 booking_disabled;
если тестовый ключ запрещён — 403 test_disabled.