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, skirtą AI agentams, kurie gali 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ų — taip 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 (slug), pavadinimu ir vienos eilutės aprašymu. |
get_doc({ slug }) | Apdorotą vieno puslapio MDX turinį. |
search_docs({ query }) | Paieška pagal subeilutę pavadinimų, aprašymų ir turinio srityse, su ištrauka aplink kiekvieną atitikmenį. |
list_pos_connectors | Aktyvias POS jungtis ir kiekvienam klientui taikomą apimties nustatymo politiką likusių atžvilgiu. |
get_pricing_scope({ locations?, region? }) | Įsitraukimo modelį (prenumerata pagal vietą, EUR), segmento rodiklius (Insights įtrauktas nuo 5 vietų, Enterprise nuo 150+) ir tinkamumo verdiktą pagal pirkėjo įvestus duomenis. 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 gauti, 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 tenantui)
Atskiras MCP serveris tiekiamas su kiekvienu Fooodo Insights tenantu. Jei aukščiau aprašytas vadovo MCP atskleidžia Fooodo viešąjį turinį ir potencialių klientų fiksavimo veiksmą, tai Insights MCP atskleidžia to tenanto nuosavą veiklos analitiką — laikotarpio suvestines, pardavimų ir rinkodaros kanalų veiklos rezultatus, produktų ir atskirų restoranų veiklos rezultatus, P&L duomenis, tris AI specialistų agentus, tarpdomeninius orkestruotoją ir ribotą rašymo veiksmų rinkinį, pvz., duomenų importo paleidimas ir įspėjimo išsprendimas.
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 tenanto 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 — 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šus 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 kiekvienam partneriui išduotais kredencialais, suteikiamais registracijos 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 (back-end)
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į, pradėkite nuo POS integracijos reikalavimų — vertinimo lygio specifikacijos — ir susisiekite per partners@fooodo.com.
Baltosios etiketės diegimas (front-end)
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 konfigūracijos paviršius, o ne API.
Įterptieji valdikliai (lengvieji)
AI Ask valdiklis šioje svetainėje gali būti įterptas į partnerių svetaines naudojant vieną scenarijaus žymą. Kiti valdikliai (meniu peržiūra, stalų 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 pateikėjo žetoną (bearer token). Slaptieji raktai išduodami kiekvienai aplinkai atskirai; testavimo ir gamybos aplinkos naudoja skirtingus žetonus. Šiandien nėra OAuth srauto — API naudojančios auditorijos yra per mažos, kad tai būtų pateisinama.
Webhooks (įeinantys, partneriams) — planuojama
Partnerių diegimams išeinantys webhooks užsakymų įvykiams yra įtraukti į integracijų planą. Planuojamas įvykių rinkinys:
order.createdorder.paidorder.cancelledorder.errored
Vidiniai įvykiai, kurie juos inicijuoja, jau egzistuoja meniu programos pusėje; išeinantis siuntėjas konfigūruojamas kiekvienam partneriui registracijos 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 neturi 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, skirtas srautui didinti ir vidutiniam čekiui kelti naudojant Fooodo — laiko langų nuolaidos, kupono kodai, POS valdomas lojalumas, 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.