Skip to content

Создать отзыв по завершённой записи

Request

Создаёт новый отзыв текущего пользователя по service record.

Требования:

  • требуется JWT
  • отзыв можно оставить только на собственную завершённую запись
  • на одну запись можно оставить только один отзыв
  • один пользователь может оставить новый отзыв на ту же услугу только через 30 дней после предыдущего
  • все media_ids, если переданы, должны быть доступны пользователю, иметь статус UPLOADED и purpose REVIEW (фото и видео) либо CARD (фото для совместимости); не более 10 файлов суммарно

Готовность прикрепляемых файлов: Все переданные media_ids должны иметь purpose REVIEW либо совместимый CARD и статус UPLOADED. PENDING и FAILED не принимаются при прикреплении новых файлов. Проверки доступа, владельца и прочие ограничения операции сохраняются. Перед отправкой дождитесь успешного ответа POST /api/file/upload.

Security
bearerAuth or jwtCookie
Bodyapplication/jsonrequired
service_record_idinteger, (int64), >= 1required

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

Example:150
ratinginteger, [ 1 .. 5 ]required

Оценка от 1 до 5.

Example:5
liked_textstring or null, [ 10 .. 1000 ] characters

Что понравилось. Если передано, длина должна быть от 10 до 1000 символов.

Example:"Очень аккуратная работа и чистое рабочее место"
disliked_textstring or null, [ 10 .. 1000 ] characters

Что не понравилось. Если передано, длина должна быть от 10 до 1000 символов.

Example:"Немного долгое ожидание перед началом"
commentstring or null, [ 10 .. 3000 ] characters

Общий комментарий к отзыву. Если передан, длина должна быть от 10 до 3000 символов.

Example:"В целом всё понравилось, результат отличный."
tagsArray of strings or null, <= 6 items, unique

До 6 уникальных тегов отзыва.

media_idsArray of integers or null, <= 10 items

Идентификаторы фото и видео, прикрепляемых к отзыву (не более 10 файлов суммарно). Каждый идентификатор должен быть положительным, файл должен быть доступен пользователю и иметь статус UPLOADED и purpose REVIEW; изображения CARD также принимаются для совместимости.

curl -i -X POST \
  https://felmee.com/api/review \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "service_record_id": 150,
    "rating": 5,
    "liked_text": "Очень аккуратная работа и чистое рабочее место",
    "disliked_text": "Немного долгое ожидание перед началом",
    "comment": "В целом всё понравилось, результат отличный.",
    "tags": [
      "CLEANLINESS",
      "PROFESSIONALISM"
    ],
    "media_ids": [
      101,
      102
    ]
  }'

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(ReviewResponse)required

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

Response
{ "success": true, "message": "Successfully leave review", "codeError": null, "error_code": null, "data": { "id": 77, "service_record_id": 150, "provider_id": 20, "executor_id": 25, "user_id": 10, "author": { … }, "service_id": 501, "service_name": "Маникюр", "start": "2026-04-20T09:00:00Z", "end": "2026-04-20T10:00:00Z", "price": 1200, "provider_name": "Flow studio", "provider_avatar_id": 900, "executor_name": "Анна Петрова", "executor_avatar_id": 701, "rating": 5, "liked_text": "Очень аккуратная работа и чистое рабочее место", "disliked_text": "Немного долгое ожидание перед началом", "comment": "В целом всё понравилось, результат отличный.", "tags": [ … ], "media_ids": [ … ], "created_at": "2026-04-28T10:30:00Z" } }