|
Методы Get Last Heroes и Get Best HeroesТип запросаGET Тип сообщенияapplication/json URLhttp://www.soopahero.com/api/heroes/last http://www.soopahero.com/api/heroes/best ОписаниеИспользуются для формирования рейтинга героев. Существует страница героев, где можно сортировать героев по дате регистрации и по количеству полученной кармы. Эти методы позволяют извлекать героев из базы данных и возвращать, как по возрастанию, так и по убыванию. Для постраничного отображения (pagination) героев используются дополнительные параметры для коротких запросов. Каждый возвращаемый герой из списка содержит в себе следующие данные:
Запрос (request)Параметры (в строке запроса):
Ответ (response)400 Bad Request Код ошибки (errorCode) InputParameterError указывает, что один из параметров в строке запроса имеет неверное значение. Параметр parameterName укажет какой параметр был передан неверно, parameterValue - текущее значение, violationMessage - какое правило было нарушено. Необходимо исправить значение, указанное в ошибке, проверить формат сообщения и отправить запрос снова. 200 OK Запрос выполнен успешно, и в ответе возвращается список героев. Список будет отсортирован по одному из двух параметров: дата регистрации или количество заработанной кармы в зависимости от вызываемого метода. Если в запросе есть параметр указывающий на порядок сортировки, то список будет отсортирован согласно используемому параметру. При желании разделить список на несколько частей необходимо использовать параметры limit и/или offset. |