Genel API

Ordering.Tools Genel API

Her işletmenin menüsünü programatik olarak okuyun ve sipariş hazırlayın. Yapay zeka ajanları, iş ortağı entegrasyonları ve toplayıcılar için tasarlanmıştır — okuma erişimi için API anahtarı gerekmez.

Genel Bakış

Ordering.Tools üzerindeki her aktif işletme otomatik olarak yapılandırılmış bir genel API üzerinden erişilebilir hale gelir. Okuma uç noktaları kimlik doğrulaması gerektirmez ve uç sunucularda önbelleğe alınır. Sipariş uç noktası işletme bazında isteğe bağlıdır, bir API anahtarı gerektirir ve müşteriye her zaman bir ödeme URL'si döndürür — kartları asla yapay zeka ajanları üzerinden otomatik olarak tahsil etmeyiz.

Okuma Erişimi (anahtar gerekmez)

ChatGPT, Claude, Perplexity ve Gemini dahil olmak üzere herkes, kimlik doğrulaması olmadan bir işletmenin profilini ve tam menüsünü alabilir.

İçerir

  • ✓Kategoriler, ürünler, fiyatlar, varyantlar, modifiye ediciler
  • ✓Alerjenler (14 AB alerjeni) ve diyet etiketleri (vegan, vejetaryen, glutensiz)
  • ✓Tek bir yanıtta etkinleştirilmiş tüm dillerde çeviriler
  • ✓Çalışma saatleri, mutfak türü, desteklenen sipariş türleri, sosyal medya bağlantıları

Sipariş Aktarımı (isteğe bağlı)

Katılım sağlayan işletmeler, yapılandırılmış bir sipariş uç noktası alır. Uç nokta sepeti sunucu tarafında doğrular ve bir ödeme URL'si döndürür — asla tahsil edilmiş bir kart değil.

Nasıl çalışır

  • ✓Ürünlerin, varyantların, modifiye edicilerin, programın ve sipariş türünün sunucu tarafı doğrulaması
  • ✓Fiyatlar veritabanından hesaplanır; yükün içindeki fiyat ipuçları göz ardı edilir
  • ✓Müşterinin onaylamak ve ödemek için ziyaret ettiği bir ödeme URL'si döndürür
  • ✓Anahtar başına hız sınırları, kötüye kullanım günlüğü ve tam denetim izi

Yapay Zeka Asistanı Entegrasyonları

ChatGPT Uygulaması

GPT Mağazası'nda 'Ordering.Tools' araması yapın. Müşteriler bir işletme bulabilir, menüye göz atabilir ve sipariş hazırlayabilir — hepsi ChatGPT içinde. Nihai onay işletmenin ödeme sayfasında gerçekleşir.

Claude MCP Sunucusu

claude mcp add @ordering-tools/mcp komutuyla kurun. findVenue, getMenu ve prepareOrder araçlarını sunar. Claude Desktop, Claude Code ve herhangi bir MCP uyumlu istemciyle çalışır.

Herhangi Bir LLM Ajanı

Herhangi bir dilde tipli bir istemci oluşturmak için aşağıdaki OpenAPI 3.1 şemasını kullanın. Şema tüm okuma uç noktalarını ve sipariş uç noktasını kapsar.

Hızlı Başlangıç

1. Bir işletme bulun

Her aktif işletmeyi genel API URL'siyle birlikte görmek için /llms.txt adresini ziyaret edin, ya da bir işletme sayfasını açıp JSON uç noktası için kanonik bağlantı başlığını kontrol edin.

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

2. Menüyü alın

GET /api/public/v1/venues/{slug}/menu tam yapılandırılmış menüyü döndürür. Yanıtı okuyun, ürünleri seçin, bir sepet oluşturun.

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

3. Siparişi aktarın

POST /api/public/v1/venues/{slug}/order isteğini sepet, müşteri bilgileri ve sipariş türüyle gönderin. Bir ödeme URL'si alın. Müşteriyi satın alımı tamamlaması için oraya yönlendirin.

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 Şeması

Tam şema her uç noktayı, istek şemasını, yanıt şemasını ve hata kodunu kapsar. TypeScript, Python, Go veya başka herhangi bir dilde otomatik olarak istemci oluşturmak için kullanın.

Özel bir entegrasyona mı ihtiyacınız var?

Bir iş ortağı entegrasyonu, bir toplayıcı veya bir yapay zeka ajanı geliştiriyor ve daha yüksek hız sınırlarına veya özel uç noktalara ihtiyacınız varsa, bizimle iletişime geçin.

Bize Ulaşın