Создаёт запрос на создание записи по услуге для выбранного пользователя.
Перед созданием сервер проверяет:
- корректность тела запроса
- что пользователь
user_idсуществует и имеет рольUSER - что услуга
service_idсуществует - что текущий пользователь может создать request по этой услуге:
- индивидуальный мастер - если услуга принадлежит ему
- владелец салона - если услуга принадлежит его салону
- админ салона с правом
RECORD_MANAGE- если услуга принадлежит его салону
Мастер или салон предлагает только услугу (и сумму для услуги с ценой «от»). Время всегда выбирает клиент при подтверждении; для салонной услуги клиент также выбирает мастера. Ненулевые master_user_id, start или end при отправке предложения запрещены и возвращают 400, даже если переданы все три поля. Отправка не создаёт запись или платёж и не резервирует слот. Доступность выбранного клиентом слота проверяется при approve. Непринятый запрос истекает через service.record.request.create-record-lifetime после создания (в текущей конфигурации — через 15 минут). После approve действует отдельный срок оплаты записи — 5 минут от создания записи. После истечения срока неоплаченная запись перестаёт блокировать слот. Следующий запуск фоновой задачи (каждые 2 минуты) удаляет запись, а запрос получает статус EXPIRED с обновлением чата по WS и результатом в service message. Если у запроса в WAITING_FOR_PAYMENT нет record_id и с момента его создания прошло 15 минут, сервер также переводит его в EXPIRED и отправляет обновление статуса и результат в чат. Такой запрос не занимает слот. Точное время истечения возвращается в request.expires_at сообщения чата.
Для фиксированной услуги price в create_record_request до approve равен null. Для услуги с ценой «от» сохраняется сумма, указанная мастером. После approve для фиксированной услуги поле получает итоговую цену выбранного слота; для услуги с ценой «от» остаётся сумма, указанная мастером. Итоговая сумма сохраняется в service_records.service_price. Для услуги с is_fix_price = false price обязателен и передаётся отправителем. Для услуги с is_fix_price = true передавать price запрещено: при создании предложения сервер сохраняет null. При approve сервер определяет цену по price_intervals для выбранного времени (или берёт базовую service.price) и применяет discount_percent. Для показа цены выбранного слота до approve клиент может использовать base_price этого слота из GET /api/record/free-slots; акционная цена final_price слота в расчёт предложения не входит.
После создания в Messenger отправляется request-сообщение:
action = CREATE_RECORDsource_request_id = create_record_request.id- payload соответствует
CreateRecordRequestPayload
Требования:
- требуется JWT
- endpoint доступен мастеру-владельцу услуги, владельцу салона или админу салона с
RECORD_MANAGE
Идентификатор услуги, по которой создаётся запрос на запись.
Идентификатор пользователя, который должен подтвердить создание записи.
Цена предложения для is_fix_price = false; обязательна и сохраняется без изменения при approve. Для is_fix_price = true передача price запрещена; до approve цена равна null, при approve рассчитывается по выбранному клиентом слоту и текущей цене услуги.
Не передавать. Допускается только null; ненулевое значение возвращает 400. Выбор выполняет клиент при approve.
Не передавать. Допускается только null; ненулевое значение возвращает 400. Выбор выполняет клиент при approve.
- https://felmee.comhttps://felmee.com/api/record/create
- http://localhost:8080http://localhost:8080/api/record/create
curl -i -X POST \
https://felmee.com/api/record/create \
-H 'Authorization: Bearer <YOUR_JWT_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"service_id": 501,
"user_id": 42,
"price": 1200
}'Запрос на создание записи успешно создан
Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.
Код ошибки. Для успешных ответов всегда null.
{ "success": true, "message": "Create record request created successfully", "codeError": null, "error_code": null, "data": null }