Verejné čítacie API Chux: adresy, parametre hľadania, tvar odpovede a chybové kódy.
Čítacia časť API je verejná a nevyžaduje kľúč. Odpovede sú JSON s obálkou data, chyby majú tvar error s kódom, správou a identifikátorom požiadavky, ktorý sa hodí do hlásenia podpore.
GET https://api.chux.cz/api/v1/search?locale=sk-SK&q=bicykel&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šetko, čo verejné API deklaruje, vygenerované z dokumentu OpenAPI, ktorý táto stránka načíta. Pri každom endpointe nájdete parametre, tvar odpovede aj formulár, z ktorého sa dá požiadavka poslať priamo odtiaľto.
Zápisy vyžadujú prihlásenie cookies a hlavičku X-CSRF-Token s rovnakou hodnotou, akú nesie cookie chux_csrf. Prihlasovanie, registrácia a nahrávanie médií majú vlastné limity požiadaviek; pri ich prekročení dostanete 429 a máte počkať, nie opakovať.
| Kód | Kedy |
|---|---|
| 400 invalid_body | Telo požiadavky nie je platný JSON alebo chýba pole |
| 401 auth_required | Chýba alebo vypršalo prihlásenie |
| 403 csrf_required | Chýba hlavička alebo cookie s tokenom |
| 404 not_found | Záznam neexistuje alebo nie je verejný |
| 429 | Prekročený limit požiadaviek |