Публичное API Chux на чтение: адреса, параметры поиска, формат ответа и коды ошибок.
Читающая часть API публична и не требует ключа. Ответы — JSON в обёртке data; ошибки имеют вид error с кодом, сообщением и идентификатором запроса, который стоит указывать в обращении в поддержку.
GET https://api.chux.cz/api/v1/search?locale=ru-RU&q=велосипед&limit=24
{
"data": [ { "id": "…", "title": "…", "priceAmount": 4500 } ],
"meta": { "count": 24 }
}| Префикс в URL | locale в API |
|---|---|
| /cz | cs-CZ |
| /sk | sk-SK |
| /ua | uk-UA |
| /ru | ru-RU |
| /en | en |
Всё, что объявляет публичный API, сгенерировано из документа OpenAPI, который загружает эта страница. У каждого эндпоинта есть параметры, форма ответа и конструктор запроса, из которого вызов можно отправить прямо отсюда.
Запись требует cookie сессии и заголовка X-CSRF-Token с тем же значением, что и cookie chux_csrf. Вход, регистрация и загрузка медиа имеют собственные лимиты запросов; при превышении вы получите 429, и это значит подождать, а не повторять.
| Код | Когда |
|---|---|
| 400 invalid_body | Тело запроса не является корректным JSON или не хватает поля |
| 401 auth_required | Нет сессии или она истекла |
| 403 csrf_required | Не хватает заголовка или cookie с токеном |
| 404 not_found | Такой записи нет или она не публична |
| 429 | Превышен лимит запросов |