Začíname

Prístupové kľúče

Po založení e-shopu v Metty dostanete dva kľúče:

kľúč	tvar	účel	umiestnenie
verejný	pk_ + 32 hexadecimálnych znakov	čítanie — widget a Search API	môže byť aj v HTML stránky
secret	sk_ + 64 hexadecimálnych znakov	zápis do katalógu — Catalog API	iba na serveri, nikdy vo frontende

Verejný kľúč je viditeľný pre každého, kto si zobrazí zdrojový kód stránky, a slúži výhradne na čítanie. Secret kľúč povoľuje zápis do katalógu, preto patrí do serverovej konfigurácie alebo do premenných prostredia.

Prvé kroky

1. Vložte widget — jeden script tag a vyhľadávanie na e-shope je funkčné.
2. Skontrolujte katalóg — produkty importujeme z feedu, prípadne ich posielate cez API.
3. Overte vyhľadávanie — vyskúšajte GET /search s niekoľkými dotazmi z vášho sortimentu.

Adresy služieb

služba	adresa
Search API	https://search.api.metty.eu
Catalog API	https://catalog.api.metty.eu
widget	https://widget.metty.eu
dokumentácia	https://docs.metty.eu

Zákaznícky náhľad, teda ukážka widgetu na vašom webe pred nasadením, beží na preview.metty.eu; odkaz naň dostanete od nás.

Režim katalógu

E-shop je vždy v jednom z dvoch režimov:

• feed — katalóg importujeme z vášho XML feedu. Neposielate nič, stačí nám URL feedu.
• content_api — katalóg posielate cez Catalog API.

Režimy sa nekombinujú a ich prepnutie vykonáva Metty. Dôvodom je, že starší feed snapshot by prepísal novšie zmeny odoslané cez API.

Kde pokračovať

• Vloženie widgetu — najrýchlejšia cesta k funkčnému vyhľadávaniu
• Prehľad API — keď chcete katalóg riadiť z vlastného systému alebo staviate vlastné UI
• PHP klient — hotová knižnica namiesto vlastných HTTP volaní
• Príklady — funkčné ukážky synchronizácie a vyhľadávania
• Chyby a limity — kódy chýb, rate limity a stratégia opakovania