create.md

Создать внутренний комментарий для магазина

POST /orders/{order_key}/shop-comments

Параметры запроса

Параметр	Тип	Описание
comment	string	Текст комментария

Пример запроса

POST /orders/1A4E94/shop-comments
Authorization: Bearer <token>
Accept: application/json; charset=utf-8
Content-Type: application/json; charset=utf-8

{
  "comment": "Текст комментария"
}

Пример ответа

{
    "id": 1,
    "user_login": "Kate",
    "comment": "Текст комментария",
    "created_at": "2020-01-01 00:00:00"
}

Ответ при запросе от пользователя без необходимых прав

HTTP/2 403 Forbidden

{
    "message": "Access denied"
}

Возможные ошибки:

Ошибки
Access denied Invalid credentials

Ответ при невалидном запросе

HTTP/2 422 Unprocessable Entity
Content-Type: application/json; charset=utf-8

{
    "message": "Validation failed",
    "errors": {
        "comment": [
            "Поле обязательно для заполнения"
        ]
    }
}

Возможные ошибки для полей:

Параметр	Ошибки
comment	Значение поля должно быть строкой Комментарий должен содержать минимум один символ Максимум 255 симоволов

Ответ при возникновении логических ошибок

HTTP/2 422 Unprocessable Entity
Content-Type: application/json; charset=utf-8

{
    "message": "Добавлено максимальное количество комментариев"
}

Возможные ошибки

Текст ошибки
Добавлено максимальное количество комментариев
Невозможно добавить комментарий к заказу