Skip to content

Создать запись

Request

Создаёт запись на услугу во внутреннем статусе WAITING_FOR_PAYMENT. В успешном ответе data содержит снимок созданной записи, включая record_id. Этот идентификатор можно использовать для последующей оплаты.

Пока оплата не подтверждена и статус не изменён на BOOKED, запись не возвращается методами получения пользовательских и провайдерских записей.

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

  • корректность тела запроса
  • что текущий пользователь имеет роль USER
  • что услуга существует
  • что для услуги салона передан master_user_id; для услуги отдельного мастера это поле передавать нельзя
  • что переданный интервал точно совпадает хотя бы с одним доступным слотом
  • что start раньше end
  • что длительность интервала не превышает 24 часа

Требования:

  • требуется JWT
Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
service_idinteger, (int64), >= 1required
master_user_idinteger or null, (int64), >= 1

ID мастера салона. Передаётся только при записи на услугу салона.

startstring, (date-time)required

Время начала бронирования в формате ISO-8601. Должно быть раньше end.

Example:"2026-03-11T10:00:00Z"
endstring, (date-time)required

Время конца бронирования в формате ISO-8601. Максимальная длительность интервала - 24 часа.

Example:"2026-03-11T11:00:00Z"
client_commentstring or null, <= 1000 characters

Необязательный комментарий клиента. Сохраняется при создании записи и не может быть изменён.

Example:"Френч, короткие ногти"
curl -i -X POST \
  https://felmee.com/api/record \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "service_id": 20,
    "start": "2026-03-11T10:00:00Z",
    "end": "2026-03-11T11:00:00Z"
  }'

Responses

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

Bodyapplication/json
codeErrorstring or nullrequired

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

successbooleanrequired

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

messagestringrequired

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

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"
dataobject or null(CreatedRecordResponse)required

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

Response
{ "success": true, "message": "Booking request created successfully", "codeError": null, "error_code": null, "data": { "record_id": 101, "service_id": 20, "provider_id": 30, "executor_id": 30, "user_id": 15, "start": "2026-03-11T10:00:00Z", "end": "2026-03-11T11:00:00Z", "status": "WAITING_FOR_PAYMENT", "service_name": "Мужская стрижка", "service_price": 1500, "service_location": "IN_SALON", "service_address": "г. Москва, ул. Тверская, д.16", "client_comment": null } }