Skip to content

Создать запрос на создание записи

Request

Создаёт запрос на создание записи по услуге для выбранного пользователя.

Перед созданием сервер проверяет:

  • корректность тела запроса
  • что пользователь 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_RECORD
  • source_request_id = create_record_request.id
  • payload соответствует CreateRecordRequestPayload

Требования:

  • требуется JWT
  • endpoint доступен мастеру-владельцу услуги, владельцу салона или админу салона с RECORD_MANAGE
Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
service_idinteger, (int64), >= 1required

Идентификатор услуги, по которой создаётся запрос на запись.

Example:501
user_idinteger, (int64), >= 1required

Идентификатор пользователя, который должен подтвердить создание записи.

Example:42
priceinteger, >= 1

Цена предложения для is_fix_price = false; обязательна и сохраняется без изменения при approve. Для is_fix_price = true передача price запрещена; до approve цена равна null, при approve рассчитывается по выбранному клиентом слоту и текущей цене услуги.

Example:1200
master_user_idinteger or null, (int64), >= 1deprecated

Не передавать. Допускается только null; ненулевое значение возвращает 400. Выбор выполняет клиент при approve.

Value:null
startstring or null, (date-time)deprecated

Не передавать. Допускается только null; ненулевое значение возвращает 400. Выбор выполняет клиент при approve.

Value:null
endstring or null, (date-time)deprecated

Не передавать. Допускается только null; ненулевое значение возвращает 400. Выбор выполняет клиент при approve.

Value:null
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
  }'

Responses

Запрос на создание записи успешно создан

Bodyapplication/json
codeErrorstring or nullrequired

Устаревший camelCase-alias поля error_code; при ошибке оба поля содержат одинаковое значение.

Example:null
successbooleanrequired

Флаг успешного выполнения запроса

Example:true
messagestringrequired

Человекочитаемое описание результата

Example:"OK"
error_codestring or null(ERROR_CODE)required

Код ошибки. Для успешных ответов всегда null.

Enum:"INVALID_BODY""INVALID_DATE""invalid_body""unauthorized""not_found""slot_unavailable""conflict""BUSINESS_INACTIVE""INSUFFICIENT_FUNDS""REQUISITES_REQUIRED"
Example:null
dataany or nullrequired

Полезная нагрузка. Может быть объектом, массивом или null.

Example:null
Response
{ "success": true, "message": "Create record request created successfully", "codeError": null, "error_code": null, "data": null }