Guest API për agjentët AI

API publik i cenaly.com, përmes të cilit asistentët dhe agjentët AI veprojnë në emër të mysafirit: lexojnë menunë e restorantit, mbledhin dhe kryejnë porosinë, rezervojnë një tavolinë. Nuk kërkohet autorizim — këto janë të njëjtat veprime që janë të disponueshme për mysafirin në faqen e menusë.

Adresimi i restorantit#

Restoranti adresohet me kodin e lokacionit — ky është segmenti i URL-së së menusë me shkronja të mëdha. Nëse menuja hapet nëpërmjet cenaly.com/MYCAFE, kodi është MYCAFE. I njëjti kod është i integruar në kodet QR të tavolinave.

Fillim i shpejtë (REST)#

# Çfarë di të bëjë API-ja
curl https://api.cenaly.com/llm/v1

# Menyja e restorantit në rusisht
curl "https://api.cenaly.com/llm/v1/locations/MYCAFE/menu?lang=ru"

# Bëni një porosi për marrje me vete
curl -X POST https://api.cenaly.com/llm/v1/locations/MYCAFE/orders \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [{"itemId": "abc123", "quantity": 2}],
    "orderType": "pickup",
    "customer": {"name": "Mysafir", "phone": "+995555123456"},
    "language": "ru"
  }'
# → {"accepted": true, "orderId": "…", "total": 24, "statusUrl": "…"}

# Statusi i porosisë (orderId — token sekret aksesi)
curl https://api.cenaly.com/llm/v1/locations/MYCAFE/orders/{orderId}

Specifikimi i plotë: OpenAPI 3.1 · dokumentacioni interaktiv (në gjuhën e markës; ?lang=en|ka|ru|tr|sq).

Pikat përfundimtare#

Metoda	Rruga	Çfarë bën
GET	`/llm/v1/locations/{DOMAIN}/menu?lang=xx`	Menyja: kategoritë, gjellët, çmimet, variantet dhe shtesat, valuta, mënyrat e marrjes
GET	`/llm/v1/locations/{DOMAIN}/items/{itemId}`	Një gjellë me opsionet
POST	`/llm/v1/locations/{DOMAIN}/orders`	Bëni një porosi (serveri validon përbërjen dhe llogarit shumat)
GET	`/llm/v1/locations/{DOMAIN}/orders/{orderId}`	Statusi i porosisë, numri, artikujt
GET	`/llm/v1/locations/{DOMAIN}/reservations/availability?start=&durationMinutes=`	Tavolina të lira/të zëna sipas skemës së sallës
POST	`/llm/v1/locations/{DOMAIN}/reservations`	Kërkesë për rezervim (pending deri sa restoranti ta konfirmojë)
GET / DELETE	`/llm/v1/locations/{DOMAIN}/reservations/{id}`	Statusi / anulimi i rezervimit

Lidhja përmes MCP#

Serveri: https://api.cenaly.com/llm/mcp — Model Context Protocol, streamable HTTP, stateless, pa autorizim.

Konfigurimi për Claude Desktop / Claude Code dhe klientët e përputhshëm:

{
  "mcpServers": {
    "meni-guest": {
      "type": "http",
      "url": "https://api.cenaly.com/llm/mcp"
    }
  }
}

Mjetet: get_menu, get_item, create_order, get_order_status, check_table_availability, create_reservation, get_reservation_status, cancel_reservation.

Skenarët tipikë:

Porosia: get_menu → create_order → get_order_status (numri me 4 shifra shfaqet pas pak sekondash).
Rezervimi i tavolinës: check_table_availability (tavolinat nga skema e sallës, e lirë/e zënë për kohën e zgjedhur) → create_reservation me tableId → get_reservation_status (restoranti konfirmon kërkesën) → nëse është e nevojshme cancel_reservation.

Rregullat dhe garancitë#

Porosia validohet sipas menusë aktive: pjata joekzistuese, opsioni ose shtesa — gabim 400 me listën e problemeve; çmimet dhe totali llogariten nga serveri, agjenti nuk ka asnjë mënyrë për të «caktuar» çmimin.
Për pickup dhe dërgesë janë të detyrueshme emri dhe telefoni i klientit; për dërgesë — adresa.
orderId / reservationId — tokena sekretë: përmes tyre verifikohet statusi dhe anulohet rezervimi. Mos i publikoni ato.
Porositë dhe rezervimet shkojnë te restoranti në kohë reale — në panelin e administrimit, në ekranin e kuzhinës dhe në njoftime, si porositë e zakonshme nga faqja e internetit.
Rezervimet e klientit kanë statusin pending, derisa restoranti t'i konfirmojë ato në panelin e administrimit.

Zbulimi i lexueshëm nga makina#

https://cenaly.com/llms.txt — hartë e shkurtër API për LLM;
https://cenaly.com/.well-known/mcp.json — manifest i serverëve MCP;
GET https://api.cenaly.com/llm/v1 — dokument zbulimi me shembuj.