API ir integracijų paviršius
Kaip partneriai ir kūrėjai integruojasi su Fooodo — viešasis MCP serveris, POS jungtis ir baltosios etiketės sutartys, kas šiandien atvira ir kas uždaryta, bei integracijų planas.
Fooodo viešasis integracijų paviršius yra nedidelis ir tikslingas. Šiame puslapyje aprašyta, kas šiandien atvira, kas uždaryta ir kas numatyta ateityje.
Kas šiandien atvira
MCP serveris
Fooodo valdo Model Context Protocol (MCP) serverį adresu /api/mcp, skirtu AI agentams užklausti vadovą ir atlikti ribotą skaičių apibrėžtų veiksmų pirkėjo vardu. Agentai skaito vadovą nenaudodami HTML grandymo ir teikia struktūrizuotas užklausas neužpildydami HTML formų — taigi partnerių palaikymo asistentai, integracijos apimties nustatymo pagalbininkai ir pirkėjo pusės įsigijimo agentai remiasi kanoniniais duomenimis ir pasiekia tinkamą pašto dėžutę.
# Connect from Claude Desktop, Cursor, or any MCP-compatible client:
mcp connect https://fooodo.com/api/mcpSkaitymo įrankiai (be šalutinių poveikių):
| Įrankis | Grąžina |
|---|---|
list_docs | Kiekvieną vadovo puslapį su nuoroda, pavadinimu ir vienos eilutės aprašymu. |
get_doc({ slug }) | Apdorotą vieno puslapio MDX turinį. |
search_docs({ query }) | Pavadinimų, aprašymų ir turinio paieška pagal subeilutę su ištrauka aplink kiekvieną atitikmenį. |
list_pos_connectors | Aktyvias POS jungtis ir kiekvieno kliento apimties nustatymo politiką likusiosioms. |
get_pricing_scope({ locations?, region? }) | Įsitraukimo modelį (prenumerata vienai vietai, EUR), segmento rodiklius („Insights" įtraukta nuo 5+ vietų, „Enterprise" nuo 150+) ir tinkamumo verdiktą pagal pirkėjo įvestis. Negrąžina kainos — platforma kainuojama individualiai kiekvienam klientui; šis įrankis grąžina įsitraukimo formą, kad pirkėjo agentas galėtų įvertinti tinkamumą prieš prašydamas pasiūlymo. |
Veiksmo įrankis (siunčia el. laišką Fooodo komandai):
| Įrankis | Atlieka |
|---|---|
request_walkthrough({ name, email, variant?, company?, role?, locations?, message?, locale?, agent_origin? }) | Siunčia potencialaus kliento el. laišką operacijų komandai pirkėjo, kuriam atstovauja agentas, vardu. Atsakymai pasiekia email per dvi darbo dienas. variant numatytoji reikšmė yra demo; nurodykite pricing pasiūlymui, partner — perpardavėjo susidomėjimui, developer — API/MCP integracijos apimties nustatymui. agent_origin rodomas el. laiške, kad operacijų komanda galėtų atskirti agentų inicijuotus potencialius klientus nuo formų pateikimų. |
Veiksmo įrankiui taikomas greičio apribojimas pagal pirkėjo el. paštą (3 per valandą), o visam MCP paviršiui — greičio apribojimas pagal IP (60 iškvietimų per minutę). Potencialių klientų el. laiškai numatytai siunčiami į info@fooodo.com.
„Insights" MCP serveris (kiekvienam nuomininkui)
Atskiras MCP serveris pateikiamas su kiekvienu Fooodo Insights nuomininku. Tuo tarpu kai aukščiau aprašytas vadovo MCP atskleidžia Fooodo viešąjį turinį ir potencialių klientų fiksavimo veiksmą, „Insights" MCP atskleidžia to nuomininko nuosavą veiklos analitiką — laikotarpio suvestines, kanalų ir produktų veiklos rezultatus, pelno ir nuostolių duomenis, tris AI specialistų agentus, tarpdomeninius orkestravimo įrankius ir ribotą rašymo veiksmų rinkinį, pvz., duomenų importo paleidimą ir įspėjimo išsprendimą.
Serveris naudoja OAuth 2.1 su dinaminiu kliento registravimu per „Streamable HTTP", todėl bet kuris MCP suderinamas klientas prisijungia tuo pačiu vieno paspaudimo srautu. Funkcija kiekvienai organizacijai numatytai yra išjungta; įjungimas ir nuomininko URL parengimas vykdomi per support@fooodo.com. Visas įrankių sąrašas, kiekvieno kliento sąranka ir saugos informacija: „Insights" MCP serveris.
LLM draugiška svetainės rodyklė
/llms.txt pateikia plokščią, struktūrizuotą kiekvieno viešo rinkodaros svetainės ir vadovo puslapio rodyklę. /llms-full.txt yra tas pats vadovas, sujungtas į vieną „Markdown" dokumentą vienkartiniam įkėlimui. Abu yra kanoniniai įėjimo taškai, jei nukreipiate LLM į Fooodo.
Svetainės žemėlapis ir „Open Graph"
Standartiniai paviršiai — /sitemap.xml apima visas 7 rinkodaros lokales × viešuosius maršrutus. „Open Graph" ir „Twitter Card" vaizdai generuojami kiekvienai lokalei.
Kas šiandien uždaryta
Meniu programos užsakymų API ir mokėjimų paslaugos mokėjimų API nėra viešos. Jos veikia infrastruktūroje, valdomoje mūsų diegimo partnerių, apsaugotoje individualiais partnerių kredencialais, išduodamais prisijungimo metu.
Jei esate POS tiekėjas, norintis integruotis su Fooodo, rašykite hello@fooodo.com — šiandien integracijos kelias yra individualus, o ne savitarnos.
Su kuo partneriai iš tikrųjų integruojasi
Šiandien egzistuojančios integracijos formos, išdėstytos pagal tai, kiek partnerių jas naudoja:
POS jungtis (galinė dalis)
Dažniausiai prašoma integracija. Nauja POS jungtis įgyvendina tą pačią išeinančią ir įeinančią sutartį, kurią naudoja R-Keeper (žr. R-Keeper integracija). Jungtis yra „Laravel" paketas, pridedamas prie meniu programos — tai nėra atskiras procesas.
Reikalingas paviršius:
- Meniu gavimas (produktai, kategorijos, modifikatoriai, kainos, mokesčių žymos)
- Užsakymo siuntimas (sukurti, atnaujinti, užrakinti, pažymėti kaip apmokėtą)
- Būsena (restoranas prisijungęs / neprisijungęs, stalo būsena)
R-Keeper yra vienintelė jungtis, šiandien veikianti gamyboje. Pati jungties sutartis yra POS agnostiška — papildomos POS jungtys nustatomos kiekvienam klientui individualiai ir kainuojamos pagal poreikį. Jei esate POS tiekėjas, suinteresuotas bendradarbiauti kuriant jungtį, susisiekite per partners@fooodo.com.
Baltosios etiketės diegimas (priekinė dalis)
Kai kurie perpardavėjai valdo Fooodo diegimą po savo prekės ženklu. Klientams skirta programa palaiko prekės ženklo konfigūraciją įmonės lygiu: logotipas, spalvų žetonai, domenas, mokėjimų prekės ženklas. Tai yra konfigūracijos paviršius, o ne API.
Įterptieji valdikliai (lengvieji)
AI klausimų valdiklis šioje svetainėje gali būti įterptas į partnerių svetaines naudojant vieną scenarijaus žymą. Kiti valdikliai (meniu peržiūra, stalo prieinamumas) dar nėra išleisti, tačiau numatyti ateityje.
Autentifikacija ir slaptieji raktai
Kai partneriai gauna API prieigą (POS jungties paketai, baltosios etiketės diegimai), autentifikacija vykdoma naudojant „bearer" prieigos raktą. Slaptieji raktai išduodami kiekvienai aplinkai atskirai; testavimo ir gamybos aplinkos naudoja skirtingus raktus. Šiandien nėra OAuth srauto — auditorijos, naudojančios API, yra per mažos, kad tai būtų pateisinama.
Žiniatinklio kabliukai (įeinantys, partneriams) — planuojama
Partnerių diegimams išeinantys žiniatinklio kabliukai užsakymų įvykiams yra integracijų plane. Planuojamas įvykių rinkinys:
order.createdorder.paidorder.cancelledorder.errored
Vidiniai įvykiai, kurie juos sukelia, jau egzistuoja meniu programos pusėje; išeinantis siuntėjas konfigūruojamas kiekvienam partneriui prisijungimo metu, o ne veikia kaip numatytoji paslauga. Jei jums reikia įvykių siuntimo kaip integracijos dalies, nurodykite tai apimties nustatymo metu — mes pridedame tai prie jūsų diegimo kaip pasirenkamą modulį.
Versijų valdymas
Vidinės API yra be versijų — meniu programa ir mokėjimų paslauga diegiamos kartu Čili Pizza atveju. Kai išoriniai partneriai pradės naudoti API, įvesime versijų žymes. Dar nepasiekėme to taško.
Greičio apribojimai
Rinkodaros svetainės viešosios API (/api/ask, /api/mcp) yra ribojamos pagal IP. Apribojimai šiuo metu nėra skelbiami; jie yra pritaikyti įprastam partnerių naudojimui ir bus atpalaiduoti partneriams, sudariusiems sutartį.
Planas
Apytiksliai pagal prioritetą:
- Antra POS jungtis — nustatomos apimties kiekvienam klientui, kai tinklas tai patvirtina.
- Tipizuotas JS SDK baltosios etiketės įterpimo srautui.
- Viešoji tik skaitoma API meniu užklausoms (kad partnerių svetainės galėtų rodyti „šiandienos meniu" nenaudodamos grandymo).
Jei kurio nors iš šių dalykų jums reikia greičiau, rašykite hello@fooodo.com — partnerių poreikiai paprastai pagreitina jų įgyvendinimą.
Nuolaidos, kuponai ir lojalumas
Operatoriaus vadovas, kaip naudojant Fooodo padidinti lankytojų srautą ir vidutinį čekį — laiko langų nuolaidos, kuponų kodai, POS valdomas lojalumas, atsiskaitymo kryžminis pardavimas, arbatpinigiai ir aukos.
Fooodo Insights
AI sprendimų intelekto sluoksnis 5–200 vietų restoranų tinklams — kiekviena rekomendacija susieta su EBIT, žmogus visada dalyvauja sprendimų priėmime, ir šešių lygių architektūra po visu tuo.