Vitrina me kodin tuaj (headless)
Rruga e zakonshme — vitrina jonë ose widget-et në sajtin tuaj. Por nëse sajtin e shkruan zhvilluesi ose agjencia juaj dhe struktura duhet të jetë plotësisht e juaja, funksionon një variant i tretë: ju merrni nga ne të dhënat dhe pranimin e porosive, ndërsa gjithë frontend-in e bëni vetë, në çfarëdo stack-u.
Leximi i të dhënave nuk kërkon çelësa dhe autorizim: gjithçka që është publike në vitrinë, është publike edhe në JSON.
Ku aktivizohet dhe cilësohet: Marketing → «Sajti im» → karta «Vitrina me kodin tuaj». Aty njëherësh — adresa e manifestit të lokacionit tuaj dhe dokumentacioni teknik.
Manifesti storefront.json
Adresa e vetme që i duhet zhvilluesit të dijë:
https://cdn.menugo.al/{ДОМЕН}/storefront.json
Në manifest — gjithçka tjetër:
| Blloku | Çfarë përmban |
|---|---|
location |
Identifikuesi, slug-u, vertikalja (restorant, dyqan, hotel, sallon) |
languages |
Gjuha e parazgjedhur dhe lista e gjuhëve të aktivizuara |
currency |
Kodi dhe simboli i monedhës |
cdnBase + data |
Shtigjet drejt menusë, profilit, faqeve, koleksioneve, komenteve |
catalog |
Modaliteti i katalogut: gjithçka në skedarë ose karta të veçanta për skedar dhe API kataloguesh |
images |
Baza e imazheve, shablloni i shtegut dhe madhësitë e disponueshme |
api |
Adresat e API-së për vizitorët, specifikimet OpenAPI dhe endpoint-i MCP |
publishId, publishedAt |
Identifikuesi i publikimit: ndryshon me çdo ri-gjenerim të të dhënave |
digests |
Digest-et e skedarëve — mundësojnë invalidimin e cache-it në mënyrë të pikësuar |
Kontrata versionohet (contractVersion), dhe pranë saj ndodhen skemat JSON — me to është e përshtatshme të validohen të dhënat dhe të gjenerohen tipet. Fushat e panjohura duhet të injorohen: kontrata zgjerohet pa prishur përputhshmërinë.
Të dhënat dhe imazhet
Gjithçka që shfaq vitrina është e disponueshme si skedarë: menyja dhe katalogu sipas gjuhëve, profili i lokacionit (emri, adresa, orari i punës, kontaktet, cilësimet), faqet dhe artikujt, koleksionet, vlerësimet.
Për kataloge të mëdha, manifesti kalon në modalitetin api: në skedarin e menysë ndodhet një zgjedhje e lehtësuar, ndërsa kartat e plota merren skedar-për-skedar ose përmes API-së së katalogut me filtra dhe nënkategori.
Imazhet vijnë nga CDN-ja jonë, në disa madhësi sipas shabllonit të manifestit; kur përditësohet foto, shtegu ndryshon version, prandaj cache-i mund të mbahet «përgjithmonë».
Porositë dhe API-ja për vizitorët
Pranimi i porosive, statusi i porosisë, kërkimi dhe rezervimet — përmes API-së për vizitorët: pa autorizim, adresa merret nga manifesti, specifikimi — OpenAPI 3.1. Veçmas ekziston kontura komerciale: kupona, llogaritja e dërgesës, formularë, abonime. Më shumë — Guest API për agjentë AI, i njëjti ndërfaqe.
Porosia, e krijuar nga faqja juaj, futet në seksionin e përbashkët «Porositë» dhe jeton sipas rregullave të zakonshme: statuse, kuzhinë, korrierë, fatura, njoftime.
Webhook-et për ndryshime
Që të mos pyesni vazhdimisht CDN-në, abonohuni te ngjarjet:
menu.updated— menyja ose katalogu janë ri-gjeneruar;profile.updated— profili i lokacionit ka ndryshuar.
Në trupin e ngjarjes vjen publishId — sipas tij është e përshtatshme të rindërtoni faqet statike ose të pastroni cache-in ISR. Çdo kërkesë nënshkruhet me HMAC-SHA256 me sekretin tuaj: kontrolloni nënshkrimin para se të rindërtoni diçka. Deri në pesë adresa për lokacion, riprovim automatik në rast dështimi.
Webhook-et konfigurohen në kartën «Vitrinë me kod tuajin» dhe janë të disponueshme në planet me pagesë; leximi i të dhënave është gjithmonë i disponueshëm.
Nga të filloni
- Hapni Marketingu → «Faqja ime» → «Vitrina me kodin tuaj» dhe kopjoni adresën e manifestit.
- Ngarkoni manifestin dhe prej tij — të dhënat e menusë dhe profilit. Në këtë hap nuk nevojiten çelësa.
- Ndërtoni faqet me framework-un tuaj; për porositë përdorni API-në për vizitorët.
- Shtoni një webhook, që të ri-ndërtoni faqen sipas ndryshimeve.
Përshkrimi i plotë teknik — te lidhja «Dokumentacioni» në të njëjtën kartë; aty gjendet edhe një shembull vitrine e gatshme dhe llms.txt për asistentët AI të zhvilluesit.
Seksione të lidhura
- Faqja ime — widget-e, nëse nuk keni nevojë të rishkruani të gjithë faqen
- Guest API për agjentë AI — i njëjti API për vizitorët
- MCP API — qasje e agjentëve AI në panel
- Dyqani online — çfarë saktësisht vjen në të dhënat e katalogut
Pyetje të shpeshta
A duhet të paguaj për leximin e të dhënave? Jo. JSON-et publike janë të disponueshme në çdo plan — janë të njëjtët skedarë që përdor vitrina jonë. Me pagesë janë vetëm webhook-et.
Po me SEO-në? Ajo është plotësisht në anën tuaj: ju vetë i mblidhni faqet dhe vetë menaxhoni markimin. Të dhënat për mikro-markimin (JSON-LD) gjenden në kontratë.
A mund ta kombinoj me vitrinën time? Po. Vitrina jonë, uixhetët dhe sajti juaj punojnë me të njëjtat të dhëna dhe me një shportë të vetme porosish.