Δημόσιο API του Ordering.Tools
Διαβάστε το μενού κάθε καταστήματος και προετοιμάστε παραγγελίες προγραμματιστικά. Σχεδιασμένο για AI πράκτορες, συνεργαζόμενες ενσωματώσεις και πλατφόρμες-aggregators — δεν απαιτείται κλειδί API για πρόσβαση ανάγνωσης.
Επισκόπηση
Κάθε ενεργό κατάστημα στο Ordering.Tools είναι αυτόματα διαθέσιμο μέσω ενός δομημένου δημόσιου API. Τα read endpoints δεν απαιτούν αυθεντικοποίηση και cache-άρονται στην edge. Το endpoint παραγγελιών απαιτεί ενεργοποίηση ανά κατάστημα, κλειδί API, και πάντα επιστρέφει στον πελάτη ένα URL ολοκλήρωσης — δεν χρεώνουμε ποτέ αυτόματα κάρτες μέσω AI πρακτόρων.
Πρόσβαση ανάγνωσης (χωρίς κλειδί)
Οποιοσδήποτε — συμπεριλαμβανομένων ChatGPT, Claude, Perplexity και Gemini — μπορεί να ανακτήσει το προφίλ και το πλήρες μενού ενός καταστήματος χωρίς αυθεντικοποίηση.
Περιλαμβάνει
- ✓Κατηγορίες, προϊόντα, τιμές, παραλλαγές, modifiers
- ✓Αλλεργιογόνα (14 αλλεργιογόνα EU) και διατροφικές σημάνσεις (vegan, vegetarian, χωρίς γλουτένη)
- ✓Μεταφράσεις σε όλες τις ενεργοποιημένες γλώσσες σε μία απάντηση
- ✓Ωράριο, κουζίνα, υποστηριζόμενοι τύποι παραγγελίας, σύνδεσμοι κοινωνικών δικτύων
Παράδοση παραγγελίας (opt-in)
Καταστήματα που ενεργοποιούν τη λειτουργία λαμβάνουν ένα δομημένο endpoint παραγγελιών. Το endpoint επικυρώνει το καλάθι στην πλευρά του server και επιστρέφει ένα URL ολοκλήρωσης — ποτέ μια χρεωμένη κάρτα.
Πώς λειτουργεί
- ✓Επικύρωση από τον server για προϊόντα, παραλλαγές, modifiers, ωράριο και τύπο παραγγελίας
- ✓Οι τιμές υπολογίζονται από τη βάση δεδομένων· οι ενδείξεις τιμών στο payload αγνοούνται
- ✓Επιστρέφει URL ολοκλήρωσης που ο πελάτης επισκέπτεται για να επιβεβαιώσει και να πληρώσει
- ✓Όρια rate ανά κλειδί, καταγραφή κατάχρησης και πλήρης διαδρομή ελέγχου
Ενσωματώσεις AI βοηθών
Εφαρμογή ChatGPT
Αναζητήστε 'Ordering.Tools' στο GPT Store. Οι πελάτες μπορούν να βρουν κατάστημα, να περιηγηθούν στο μενού και να προετοιμάσουν παραγγελία — όλα μέσα στο ChatGPT. Η τελική επιβεβαίωση γίνεται στη σελίδα checkout του καταστήματος.
Claude MCP Server
Εγκαταστήστε με claude mcp add @ordering-tools/mcp. Εκθέτει εργαλεία findVenue, getMenu και prepareOrder. Λειτουργεί με Claude Desktop, Claude Code και κάθε MCP-συμβατό client.
Οποιοσδήποτε LLM πράκτορας
Χρησιμοποιήστε την προδιαγραφή OpenAPI 3.1 παρακάτω για να δημιουργήσετε typed client σε οποιαδήποτε γλώσσα. Η προδιαγραφή καλύπτει όλα τα read endpoints και το endpoint παραγγελιών.
Γρήγορη εκκίνηση
1. Βρείτε ένα κατάστημα
Επισκεφθείτε το /llms.txt για να δείτε κάθε ενεργό κατάστημα με το δημόσιο API URL του, ή ανοίξτε τη σελίδα ενός καταστήματος και ελέγξτε το canonical link header για το JSON endpoint του.
2. Φέρτε το μενού
GET /api/public/v1/venues/{slug}/menu επιστρέφει το πλήρες δομημένο μενού. Διαβάστε την απάντηση, επιλέξτε προϊόντα, χτίστε ένα καλάθι.
curl https://www.ordering.tools/api/public/v1/venues/london-pub/menu3. Παραδώστε την παραγγελία
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, σχήμα αιτήματος, σχήμα απάντησης και κωδικούς σφαλμάτων. Χρησιμοποιήστε τη για να δημιουργήσετε αυτόματα clients σε TypeScript, Python, Go ή κάθε άλλη γλώσσα.
Χρειάζεστε custom ενσωμάτωση;
Αν χτίζετε συνεργαζόμενη ενσωμάτωση, aggregator ή AI πράκτορα και χρειάζεστε υψηλότερα όρια rate ή custom endpoints, επικοινωνήστε μαζί μας.
Επικοινωνήστε μαζί μας