Veřejné čtecí API Chux: adresy, parametry hledání, tvar odpovědi a chybové kódy.
Čtecí část API je veřejná a nevyžaduje klíč. Odpovědi jsou JSON s obálkou data, chyby mají tvar error s kódem, zprávou a identifikátorem požadavku, který se hodí do hlášení podpoře.
GET https://api.chux.cz/api/v1/search?locale=cs-CZ&q=kolo&limit=24
{
"data": [ { "id": "…", "title": "…", "priceAmount": 4500 } ],
"meta": { "count": 24 }
}| Jazyk v URL | locale v API |
|---|---|
| /cz | cs-CZ |
| /sk | sk-SK |
| /ua | uk-UA |
| /ru | ru-RU |
| /en | en |
Vše, co veřejné API deklaruje, vygenerované z dokumentu OpenAPI, který tato stránka načítá. U každého endpointu najdete parametry, tvar odpovědi i formulář, ze kterého lze poslat požadavek rovnou odsud.
Zápisy vyžadují přihlášení cookies a hlavičku X-CSRF-Token se stejnou hodnotou, jakou nese cookie chux_csrf. Přihlašování, registrace a nahrávání médií mají vlastní limity požadavků; při jejich překročení dostanete 429 a máte počkat, ne opakovat.
| Kód | Kdy |
|---|---|
| 400 invalid_body | Tělo požadavku není platný JSON nebo chybí pole |
| 401 auth_required | Chybí nebo vypršelo přihlášení |
| 403 csrf_required | Chybí hlavička nebo cookie s tokenem |
| 404 not_found | Záznam neexistuje nebo není veřejný |
| 429 | Překročený limit požadavků |