Content API — prehľad

Synchronizácia katalógu bez feedu a vyhľadávanie cez HTTP. Zdrojom pravdy je databáza Metty, index sa aktualizuje hneď po zápise.

Nejde o drop-in kompatibilitu s Luigi's Box — cesty a tvar payloadov sú podobné, ale podporujeme len to, čo vieme naozaj obslúžiť.

Základ

https://api.metty.eu

Kľúče

kľúč	endpointy	ako sa posiela
api_key	čítacie (/search, /autocomplete/v2, /v1/facet_value)	query parameter api_key
secret_key	zápisové (/v1/content*, /v1/content_export)	hlavička Authorization: Bearer msk_…

secret_key nikdy nepatrí do frontendu. Zápis chodí zo servera, nie z prehliadača.

Hlavičku Authorization nikde nelogujeme. Cez čisté HTTP ju endpoint odmietne — nepresmeruje, lebo kľúč už odišiel po drôte.

Režim katalógu

E-shop je buď v režime feed (katalóg ťaháme z XML), alebo content_api (posielaš ho ty). Režimy sa nemiešajú, lebo starší feed snapshot by prepísal novšie zmeny z API.

Zápis do e-shopu v režime feed vráti 409 catalog_mode_conflict. Prepnutie rieši Metty.

Čo API vie

oblasť	endpoint
zápis katalógu	POST / PATCH / DELETE /v1/content
bezpečný full snapshot	POST /v1/content/commit
export katalógu	GET /v1/content_export
vyhľadávanie	GET /search
našepkávanie	GET /autocomplete/v2
hodnoty facetu	GET /v1/facet_value

Čo API zámerne nerobí

Kampane a pinning, analytiku, personalizáciu, geo ranking, vnorené objekty ani objekty typu category, brand a article.

Keď pošleš parameter, ktorý by zmenil výsledok a nevieme ho obslúžiť, vrátime chybu s jeho menom. Tichý filter, ktorý sa neaplikuje, je horší než chyba.