Ошибки

Статус говорит, что произошло. 4xx значит, что запрос нельзя выполнить в таком виде, а 5xx — что стоит попробовать ещё раз.

200, 201Получилось. В теле ответа результат.
204Получилось, а отвечать нечем.
400Тело не является корректным JSON, неверный фильтр или нет обязательного заголовка.
401Ключа нет, или он неизвестен.
402На балансе не хватает денег на покупку.
403Этому аккаунту это недоступно.
404Такого нет, или копии инвентаря ещё нет.
409Что-то изменилось: лот продан, цена новая, сделка ушла дальше. Прочитайте заново.
413Загрузка больше допустимого размера.
422Значение в запросе нельзя использовать.
429Слишком много запросов. Подождите Retry-After.
502Сервис за API недоступен. Повторите чуть позже.

Отказы

Когда с причиной можно что-то сделать, тело ответа называет её в code. Эти коды не меняются, на них может полагаться программа. Остальные сбои — это статус и строка текста для людей.

{ "code": "not_enough_money" }
СтатусКодКогда
400bad_addressЭто не адрес Tron.
400bad_imageК сообщению можно приложить до 3 скриншотов PNG или JPEG, каждый до 8 МБ.
400bad_ticketУ обращения должна быть тема и сообщение до 2000 символов.
400too_littleВывести можно не меньше $1.00.
400unknown_coinЭту монету в этой сети Rockvel не отправляет.
402not_enough_moneyНа балансе не хватает денег.
403bannedЭтот аккаунт не может начинать на Rockvel ничего нового.
403not_your_orderСделка не ваша, или этот шаг принадлежит другой стороне.
403stall_suspendedRockvel приостановил вашу витрину, и снять это может только Rockvel.
404no_such_auto_buyТакой ждущей автопокупки нет: она купила всё, отменена или не ваша.
404no_such_bargainТакого торга, ждущего вашего ответа, нет: он закончился, сейчас очередь другой стороны или он не ваш.
404no_such_orderТакой сделки нет.
404no_such_ticketТакого вашего обращения нет.
404no_such_withdrawalТакого вашего вывода нет.
409already_listedОдин из предметов уже выставлен или продан.
409already_signedВывод уже подписан и уходит.
409buyer_cannot_payУ покупателя больше нет денег на эту цену, поэтому торг закончился.
409item_goneПредмета нет в копии инвентаря. Загрузите свежую и попробуйте снова.
409item_unknownПредмета ещё нет в каталоге.
409lot_goneЛот продан или снят.
409no_trade_urlСначала укажите трейд-ссылку.
409none_matchСейчас ни один лот не подходит под цену и фильтры.
409not_refundableСтолько депозиты не вернут, или источнику досталось бы меньше минимума.
409order_moved_onСделка ушла дальше, и этот шаг уже невозможен. Прочитайте её заново.
409own_lotЭто ваш собственный лот.
409price_changedПродавец сменил цену. Прочитайте лот и попробуйте снова.
409ticket_closedОбращение закрыто: откройте новое.
409too_earlyУ продавца ещё есть время: дождитесь buyer_cancels_at.
409too_many_auto_buysУ вас уже ждут 100 автопокупок. Сначала отмените одну.
409too_many_bargainsУ вас уже ждут ответа 100 цен. Сначала отзовите одну.
409too_many_ticketsУ вас открыто столько обращений, сколько можно.
409wait_for_answerДождитесь ответа поддержки, прежде чем писать ещё.
422bad_bargainЛот не принимает торг, цена не ниже цены лота или не в пределах его max_discount, или встречная цена не между ценой покупателя и ценой лота.
422bad_descriptionОписание длиннее 32 символов, в нём несколько строк или пробелы по краям.
422bad_discountСкидка вне диапазона от 0 до 50 процентов.
422bad_lotСписок пуст, цена вне диапазона от 3 до 100000000 центов или фильтр вне своих границ.
422bad_trade_urlЭто не трейд-ссылка этого аккаунта Steam.
422one_buyer_per_offerВсе сделки одного оффера должны идти одному покупателю.
422too_many_lotsБольше 100 предметов в одном запросе.