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