Публічне API Chux на читання: адреси, параметри пошуку, формат відповіді та коди помилок.
Читальна частина API публічна й не потребує ключа. Відповіді — JSON з обгорткою data; помилки мають вигляд error з кодом, повідомленням та ідентифікатором запиту, який варто наводити у зверненні до підтримки.
GET https://api.chux.cz/api/v1/search?locale=uk-UA&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 | Перевищено ліміт запитів |