Ordering.Tools
Ordering.Tools
Feed them, keep them
Публично API

Публично API на Ordering.Tools

Четете менюто на всеки обект и подготвяйте поръчки програмно. Проектирано за AI агенти, партньорски интеграции и агрегатори — без API ключ за достъп до четене.

Преглед

Всеки активен обект в Ordering.Tools е автоматично достъпен чрез структурирано публично API. Endpoint-ите за четене не изискват автентикация и са кеширани в edge мрежата. Endpoint-ът за поръчки изисква активиране от обекта, API ключ, и винаги връща URL за плащане към клиента — никога не зареждаме автоматично карти през AI агенти.

Достъп за четене (без ключ)

Всеки — включително ChatGPT, Claude, Perplexity и Gemini — може да чете профила на обект и пълното меню без автентикация.

Включва

  • Категории, продукти, цени, варианти, модификатори
  • Алергени (14 EU алергена) и dietary флагове (веган, вегетариански, без глутен)
  • Преводи на всички активирани езици в един отговор
  • Работно време, кухня, поддържани типове поръчки, социални връзки

Предаване на поръчка (по избор)

Обекти, които активират функцията, получават структуриран endpoint за поръчки. Endpoint-ът валидира количката от страна на сървъра и връща URL за плащане — никога не зарежда карта автоматично.

Как работи

  • Сървърна валидация на продукти, варианти, модификатори, разписание и тип поръчка
  • Цените се изчисляват от базата; ценовите хинтове в payload-а се игнорират
  • Връща URL за плащане, който клиентът посещава, за да потвърди и плати
  • Rate limit-и за всеки ключ, логване на злоупотреби и пълна одиторска следа

Интеграции с AI асистенти

ChatGPT приложение

Потърсете 'Ordering.Tools' в GPT Store. Клиентите могат да намерят обект, да разгледат менюто и да подготвят поръчка — всичко в ChatGPT. Финалното потвърждение се случва на checkout страницата на обекта.

Claude MCP сървър

Инсталирайте с claude mcp add @ordering-tools/mcp. Излага инструменти findVenue, getMenu и prepareOrder. Работи с Claude Desktop, Claude Code и всеки MCP-съвместим клиент.

Всеки LLM агент

Използвайте OpenAPI 3.1 спецификацията по-долу, за да генерирате типизиран клиент на всеки език. Спецификацията покрива всички endpoint-и за четене и endpoint-а за поръчки.

Бърз старт

1. Намерете обект

Посетете /llms.txt, за да видите всеки активен обект с публичния му API URL, или отворете страницата на обект и проверете canonical link header за JSON endpoint-а.

https://www.ordering.tools/llms.txt

2. Заредете менюто

GET /api/public/v1/venues/{slug}/menu връща пълното структурирано меню. Прочетете отговора, изберете артикули, изградете количка.

curl https://www.ordering.tools/api/public/v1/venues/london-pub/menu

3. Предайте поръчката

POST /api/public/v1/venues/{slug}/order с количката, информация за клиента и тип поръчка. Получавате URL за плащане. Изпратете клиента там, за да завърши покупката.

POST https://www.ordering.tools/api/public/v1/venues/london-pub/order
X-API-Key: <your-key>
Content-Type: application/json

{
  "items": [{ "productId": 42, "quantity": 1 }],
  "orderType": "PICKUP",
  "customer": { "name": "...", "phone": "..." }
}

OpenAPI 3.1 спецификация

Пълната спецификация покрива всеки endpoint, request schema, response schema и кодове на грешки. Използвайте я за автоматично генериране на клиенти в TypeScript, Python, Go или всеки друг език.

Нужна ви е custom интеграция?

Ако изграждате партньорска интеграция, агрегатор или AI агент и се нуждаете от по-високи rate limit-и или custom endpoint-и, свържете се с нас.

Свържете се с нас