ვიტრინა საკუთარ კოდზე (headless)

ჩვეულებრივი გზა — ჩვენი ვიტრინა ან ვიჯეტები თქვენს საიტზე. მაგრამ თუ საიტს წერს თქვენი დეველოპერი ან სააგენტო და დიზაინი სრულად საკუთარი უნდა იყოს, მუშაობს მესამე ვარიანტიც: თქვენ იღებთ ჩვენგან მონაცემებსა და შეკვეთების მიღებას, ხოლო მთელ ფრონტენდს აკეთებთ თავად, ნებისმიერ სტეკზე.

მონაცემების წაკითხვა არ საჭიროებს გასაღებებსა და ავტორიზაციას: ყველაფერი, რაც ვიტრინაზე საჯაროა, საჯაროა JSON-შიც.

სად ირთვება და კონფიგურირდება: მარკეტინგი → «ჩემი საიტი» → ბარათი «ვიტრინა საკუთარ კოდზე». იქვე — თქვენი ლოკაციის მანიფესტის მისამართი და ტექნიკური დოკუმენტაცია.

Manifest storefront.json

ერთადერთი მისამართი, რომელიც დეველოპერს სჭირდება:

https://cdn.meni.ge/{დომენი}/storefront.json

მანიფესტში — ყველაფერი დანარჩენი:

კონტრაქტს აქვს ვერსია (contractVersion), ხოლო გვერდით არის JSON-სქემები — მათი მიხედვით მოსახერხებელია მონაცემთა ვალიდაცია და ტიპების გენერაცია. უცნობი ველები საჭიროა იგნორირდეს: კონტრაქტი ფართოვდება თავსებადობის დარღვევის გარეშე.

მონაცემები და გამოსახულებები

ყველაფერი, რასაც ვიტრინა აჩვენებს, ხელმისაწვდომია ფაილებად: მენიუ და კატალოგი ენების მიხედვით, ლოკაციის პროფილი (სახელი, მისამართი, სამუშაო საათები, კონტაქტები, პარამეტრები), გვერდები და სტატიები, კოლექციები, შეფასებები.

დიდი კატალოგებისთვის მანიფესტი გადადის api რეჟიმზე: მენიუს ფაილში მდებარეობს გამარტივებული ნაკრები, სრული ბარათები მოიპოვება ფაილების მიხედვით ან კატალოგის API-ის საშუალებით ფილტრებითა და ქვეკატეგორიებით.

გამოსახულებები — ჩვენი CDN-იდან, რამდენიმე ზომაში მანიფესტის შაბლონის მიხედვით; ფოტოს განახლებისას გზა ვერსირდება, ამიტომ ქეში შესაძლებელია „სამუდამოდ“ იქნას შენახული.

შეკვეთები და სტუმრის API

შეკვეთების მიღება, შეკვეთის სტატუსი, ძიება და ჯავშნები — სტუმრის API-ის მეშვეობით: ავტორიზაციის გარეშე, მისამართი აღებულია მანიფესტიდან, სპეციფიკაცია — OpenAPI 3.1. ცალკე არსებობს კომერციული კონტური: კუპონები, მიწოდების გაანგარიშება, ფორმები, გამოწერები. დეტალურად — Guest API AI-აგენტებისთვის, იგივე ინტერფეისი.

შეკვეთა, რომელიც თქვენმა საიტმა შექმნა, ხვდება საერთო განყოფილებაში „შეკვეთები" და ცხოვრობს ჩვეულებრივი წესებით: სტატუსები, სამზარეულო, კურიერები, ჩეკები, შეტყობინებები.

ვებჰუკები ცვლილებების შესახებ

რომ არ მოგიწიოთ CDN-ის გამოკითხვა, გამოიწერეთ მოვლენები:

• menu.updated — მენიუ ან კატალოგი ხელახლა გენერირდა;
• profile.updated — შეიცვალა ლოკაციის პროფილი.

მოვლენის სხეულში მოდის publishId — მისი მეშვეობით მოსახერხებელია სტატიკური გვერდების ხელახლა აწყობა ან ISR-ქეშის ჩამოყრა. ყოველი მოთხოვნა ხელმოწერილია HMAC-SHA256-ით თქვენი საიდუმლოთი: შეამოწმეთ ხელმოწერა, სანამ რაიმეს ხელახლა აწყობთ. მაქსიმუმ ხუთი მისამართი ლოკაციაზე, გამეორებული მცდელობა ჩავარდნისას.

ვებჰუკები კონფიგურდება ბარათში „ვიტრინა საკუთარ კოდზე" და ხელმისაწვდომია ფასიან ტარიფებზე; მონაცემების წაკითხვა ყოველთვის ხელმისაწვდომია.

საიდან დავიწყოთ

1. გახსენით მარკეტინგი → «ჩემი საიტი» → «ვიტრინა საკუთარ კოდზე» და დააკოპირეთ მანიფესტის მისამართი.
2. ჩატვირთეთ მანიფესტი და მისგან — მენიუსა და პროფილის მონაცემები. ამ საფეხურზე გასაღებები არ არის საჭირო.
3. შეაგროვეთ გვერდები თქვენი ფრეიმვორკით; შეკვეთებისთვის გამოიყენეთ სტუმარი-API.
4. დაამატეთ ვებჰუკი, რომ საიტი ხელახლა აწყოთ ცვლილებების ფაქტის მიხედვით.

სრული ტექნიკური აღწერა — ბმულზე «დოკუმენტაცია» იმავე ბარათში; იქვე ცხოვრობს მზა ვიტრინის მაგალითი და llms.txt დეველოპერის AI-ასისტენტებისთვის.

დაკავშირებული განყოფილებები

• ჩემი საიტი — ვიჯეტები, თუ საიტის სრულად ხელახლა დაწერა საჭირო არ არის
• Guest API AI-აგენტებისთვის — იგივე სტუმარი-API
• MCP API — AI-აგენტების წვდომა კაბინეტთან
• ონლაინ მაღაზია — რა ზუსტად ჩამოდის კატალოგის მონაცემებში

ხშირად დასმული კითხვები

საჭიროა თუ არა მონაცემების წაკითხვის გადახდა? არა. საჯარო JSON ხელმისაწვდომია ნებისმიერ ტარიფზე — ეს იგივე ფაილებია, რომლებსაც ჩვენი ვიტრინა იყენებს. ფასიანია მხოლოდ ვებჰუკები.

რა ხდება SEO-სთან? ის მთლიანად თქვენს მხარეზეა: გვერდებს თავად აწყობთ და თავად მართავთ სემანტიკურ მარკირებას. მიკროსემანტიკის მონაცემები (JSON-LD) კონტრაქტში არის.

შესაძლებელია თუ არა საკუთარ ვიტრინასთან შეთავსება? დიახ. ჩვენი ვიტრინა, ვიჯეტები და თქვენი საკუთარი საიტი მუშაობს ერთსა და იმავე მონაცემებთან და ერთ შეკვეთების კალათასთან.