Skip to content

Обновить пост

Request

Неизменённые изображения текущего поста разрешены при редактировании ADMIN с SALON_PAGE. Новые изображения должны принадлежать владельцу поста, иметь purpose BLOG и статус UPLOADED. Удаление изображения из одного поста не удаляет файл, пока он используется другим постом.

Частично обновляет пост по его идентификатору.

Правила валидации:

  • хотя бы одно поле должно быть заполнено корректно
  • text, если передан, не должен быть пустым и не должен быть длиннее 2000 символов
  • title, если передан, не должен быть пустым и не должен быть длиннее 150 символов
  • images, если передан, должен содержать от 1 до 10 уникальных положительных ID файлов
  • tag, если передан, не должен быть пустым и не должен быть длиннее 30 символов

Доступ:

  • требуется JWT
  • role MASTER or role SALON is required
  • for role SALON, owner can write; admin needs SALON_PAGE
  • пользователь должен иметь доступ к посту
  • новые файлы из images должны принадлежать владельцу поста, иметь purpose BLOG и статус UPLOADED; текущие изображения поста можно сохранить без повторной привязки

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

Security
bearerAuth or jwtCookie
Path
idinteger, (int64), >= 1required

Идентификатор поста

Bodyapplication/jsonrequired
textstring or null, [ 1 .. 2000 ] characters.*\S.*
titlestring or null, [ 1 .. 150 ] characters.*\S.*
imagesArray of integers or null, [ 1 .. 10 ] items, unique

IDs изображений поста. Порядок элементов сохраняется в ответах. Новые файлы должны принадлежать владельцу поста, иметь purpose BLOG и статус UPLOADED; ширина и высота исходного изображения должны быть не меньше 900, соотношение сторон — не больше 3:1.

tagstring or null, [ 1 .. 30 ] characters.*\S.*
curl -i -X PATCH \
  'https://felmee.com/api/blog/{id}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "Свежая работа"
  }'

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

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

Response
{ "success": true, "message": "Post updated successfully", "codeError": null, "error_code": null, "data": { "changed": true, "post": { … } } }