Метод Ban Hero

Тип запроса

PUT

Тип сообщения

application/json

URL

http://www.soopahero.com/api/heroes/{nickname}/ban

Описание

Когда пользователь попадает на страницу героя, он может пожаловаться на него. Этот метод используется, чтобы оформить жалобу на героя.

Запрос (request)

Параметры (в теле запроса):

  • author (автор) - прозвище (nickname) героя, который оформляет жалобу
  • reason (причина) - текстовое описание причины для блокировки героя, не более 400 символов
  • token (токен) - строка, использованная для авторизации, значение возвращается одним из методом ресурса 'login', или методом 'register' ресурса 'heroes'

Ответ (response)

401 Unauthorized

Код ошибки (errorCode) WrongNicknameError указывает, что параметр token в строке запроса не соответствует ни одному зарегисрированному герою. Код ошибки (errorCode) NoTokenError указывает, что параметр token в строке запроса пустой. Необходимо проверить значение параметра token и отправить запрос снова.

404 Not Found

Герой с прозвищем nickname и/или c прозвищем author не зарегистрирован в системе. Проверьте правильно написания параметрa nickname в строке запроса и параметра author в теле запроса и отправьте запрос ещё раз.

204 Success

Запрос выполнен успешно. Жалоба на героя успешно оформлена и будет передана администратору на рассмотрение.