API un integrācijas virsma
Kā partneri un izstrādātāji integrējas ar Fooodo — publiskais MCP serveris, POS savienotājs un white-label līgumi, kas šodien ir atvērts un kas nav, un integrācijas ceļvedis.
Fooodo publiskā integrācijas virsma ir neliela un fokusēta. Šī lapa dokumentē to, kas šodien ir atvērts, kas ir slēgts un kas ir ceļvedī.
Kas šodien ir atvērts
MCP serveris
Fooodo darbina Model Context Protocol (MCP) serveri adresē /api/mcp, lai AI aģenti varētu vaicāt rokasgrāmatu un veikt nelielu skaitu ierobežotu darbību pircēja vārdā. Aģenti lasa rokasgrāmatu, neveicot HTML skrāpēšanu, un iesniedz strukturētus pieprasījumus, neaizpildot HTML veidlapas — tādējādi partneru atbalsta asistenti, integrācijas apjoma noteikšanas kopiloti un pircēja puses iepirkumu aģenti paliek balstīti kanoniskajos datos un nonāk pareizajā iesūtnē.
# Connect from Claude Desktop, Cursor, or any MCP-compatible client:
mcp connect https://fooodo.com/api/mcpLasīšanas rīki (bez blakusefektiem):
| Rīks | Atgriež |
|---|---|
list_docs | Katru rokasgrāmatas lapu ar slug, nosaukumu un vienas rindas aprakstu. |
get_doc({ slug }) | Vienas lapas apstrādāto MDX saturu. |
search_docs({ query }) | Apakšvirknes meklēšanu pār nosaukumiem, aprakstiem un pamattekstiem, ar fragmentu ap katru atbilstību. |
list_pos_connectors | Aktīvos POS savienotājus un pārējo apjoma noteikšanas politiku katram klientam. |
get_pricing_scope({ locations?, region? }) | Sadarbības modeli (abonements par atrašanās vietu, EUR), segmenta indikatorus (Insights iekļauts no 5+ atrašanās vietām, Enterprise no 150+) un piemērotības vērtējumu pircēja ievadītajiem datiem. Neatgriež cenu — platforma tiek kotēta katram klientam individuāli; šis rīks atgriež sadarbības formu, lai pircēja aģents var kvalificēties pirms piedāvājuma pieprasīšanas. |
Darbības rīks (nosūta e-pastu Fooodo komandai):
| Rīks | Dara |
|---|---|
request_walkthrough({ name, email, variant?, company?, role?, locations?, message?, locale?, agent_origin? }) | Nosūta potenciālā klienta e-pastu operācijām tā pircēja vārdā, kuru aģents pārstāv. Atbildes tiek nosūtītas uz email divu darba dienu laikā. variant pēc noklusējuma ir demo; norādiet pricing piedāvājumam, partner tālākpārdevēja interesēm, developer API/MCP integrācijas apjoma noteikšanai. agent_origin tiek parādīts e-pastā, lai operācijas var atsevišķi apstrādāt aģentu vadītus potenciālos klientus no veidlapu iesniegumiem. |
Darbības rīkam ir ātruma ierobežojums katram pircēja e-pastam (3 stundā), un visai MCP virsmei ir ātruma ierobežojums katram IP (60 izsaukumi minūtē). Potenciālo klientu e-pasti pēc noklusējuma tiek novirzīti uz info@fooodo.com.
Insights MCP serveris (katram tenantam)
Atsevišķs MCP serveris tiek piegādāts ar katru Fooodo Insights tenantu. Kamēr iepriekš minētais rokasgrāmatas MCP atklāj Fooodo publisko saturu un potenciālo klientu uztveršanas darbību, Insights MCP atklāj konkrētā tenanta pašu operatīvo analītiku — perioda kopsavilkumus, pārdošanas un mārketinga kanālu veiktspēju, produktu un katras restorāna veiktspēju, P&L datus, trīs AI speciālistu aģentus, starpdomēnu orķestratoru un ierobežotu rakstīšanas darbību kopu, piemēram, aktivizēt datu importu un atrisināt brīdinājumu.
Serveris izmanto OAuth 2.1 ar Dynamic Client Registration pār Streamable HTTP, tāpēc jebkurš MCP saderīgs klients pieslēdzas ar to pašu viena klikšķa plūsmu. Funkcija pēc noklusējuma ir deaktivizēta katrai organizācijai; aktivizēšana un tenanta URL nodrošināšana tiek veikta caur support@fooodo.com. Pilns rīku saraksts, katram klientam paredzētā iestatīšana un drošības informācija: Insights MCP serveris.
LLM draudzīgs vietnes indekss
/llms.txt nodrošina plakanu, strukturētu indeksu katrai publiskajai lapai mārketinga vietnē un rokasgrāmatā. /llms-full.txt ir tā pati rokasgrāmata, kas savienota kā viens Markdown dokuments vienreizējai uzņemšanai. Abi ir kanoniskās ieejas punkti, ja jūs norādāt LLM uz Fooodo.
Vietnes karte un Open Graph
Standarta virsmas — /sitemap.xml aptver visas 7 mārketinga lokalizācijas × publiskos maršrutus. Open Graph un Twitter Card attēli tiek ģenerēti katrai lokalizācijai.
Kas šodien ir slēgts
Izvēlnes lietotnes pasūtījumu API un maksājumu pakalpojuma maksājumu API nav publiski. Tie darbojas uz infrastruktūras, kas tiek ekspluatēta mūsu izvietošanas partneriem, nodrošināta ar katram partnerim izsniegtu akreditāciju, kas tiek piešķirta onboarding laikā.
Ja esat POS pārdevējs, kurš vēlas integrēties ar Fooodo, rakstiet uz hello@fooodo.com — integrācijas ceļš šodien ir individuāls, nevis pašapkalpošanās.
Ar ko partneri faktiski integrējas
Šodien pastāvošās integrācijas formas, sakārtotas pēc tā, cik daudz partneru tās izmanto:
POS savienotājs (aizmugursistēma)
Visvairāk pieprasītā integrācija. Jauns POS savienotājs ievieš to pašu izejošo un ienākošo līgumu, ko izmanto R-Keeper (skatīt R-Keeper integrācija). Savienotājs ir Laravel pakotne, kas pievienota izvēlnes lietotnei — tas nav atsevišķs process.
Nepieciešamā virsma:
- Izvēlnes iegūšana (produkti, kategorijas, modifikatori, cenas, nodokļu karodziņi)
- Pasūtījuma nosūtīšana (izveidot, atjaunināt, bloķēt, atzīmēt kā apmaksātu)
- Statuss (restorāns tiešsaistē/bezsaistē, galda stāvoklis)
R-Keeper ir vienīgais savienotājs, kas šodien darbojas ražošanā. Savienotāja līgums pats par sevi ir POS neatkarīgs — papildu POS savienotāji tiek noteikti katram klientam un kotēti pēc pieprasījuma. Ja esat POS pārdevējs, kurš ir ieinteresēts sadarboties savienotāja izstrādē, sāciet ar POS integrācijas prasībām — novērtēšanas līmeņa specifikāciju — un sazinieties caur partners@fooodo.com.
White-label izvietošana (priekšgalsistēma)
Daži tālākpārdevēji darbina Fooodo izvietošanu zem sava zīmola. Klientam paredzētā lietotne atbalsta zīmola konfigurāciju uzņēmuma līmenī: logotips, krāsu marķieri, domēns, maksājumu zīmolvedība. Tā ir konfigurācijas virsma, nevis API.
Iegultie logrīki (vieglā versija)
AI Ask logrīku šajā vietnē var iegult partneru vietnēs ar vienu skripta tagu. Citi logrīki (izvēlnes priekšskatījums, galdu pieejamība) vēl nav piegādāti, bet ir ceļvedī.
Autentifikācija un noslēpumi
Kad partneri iegūst API piekļuvi (POS savienotāju pakotnes, white-label izvietošanas), autentifikācija ir bearer token. Noslēpumi tiek izsniegti katrai videi; testēšanas un ražošanas vides izmanto atsevišķus tokenus. Šodien nav OAuth plūsmas — API izmantojošā auditorija ir pārāk maza, lai to pamatotu.
Webhooks (ienākoši, partneriem) — plānots
Partneru izvietošanām pasūtījumu notikumu izejošie webhooks ir integrācijas ceļvedī. Plānotais notikumu kopums:
order.createdorder.paidorder.cancelledorder.errored
Iekšējie notikumi, kas virza šos, jau pastāv izvēlnes lietotnes pusē; izejošais dispečers tiek savienots katram partnerim onboarding laikā, nevis darbojas kā noklusējuma pakalpojums. Ja jums nepieciešama notikumu nosūtīšana kā daļa no jūsu integrācijas, izvirziet to apjoma noteikšanas laikā — mēs to pievienojam jūsu izvietošanai kā izvēles moduli.
Versiju pārvaldība
Iekšējie API ir bez versijām — izvēlnes lietotne un maksājumu pakalpojums tiek izvietoti kopā Čili Pizza vajadzībām. Tiklīdz ārējie partneri izmantos API, mēs ieviesīsim versiju atzīmes. Mēs vēl neesam sasnieguši šo punktu.
Ātruma ierobežojumi
Mārketinga vietnes publiskajiem API (/api/ask, /api/mcp) ir ātruma ierobežojums katram IP. Ierobežojumi pašlaik nav publicēti; tie ir dimensionēti parastajai partneru lietošanai un tiks atviegloti partneriem, kas ir noslēguši darījumu.
Ceļvedis
Aptuveni prioritātes secībā:
- Otrs POS savienotājs — tiek noteikts katram klientam, kad ķēde tam apņemas.
- Tipizēts JS SDK white-label iegulšanas plūsmai.
- Publisks tikai lasāms API izvēlnes vaicājumiem (lai partneru vietnes var parādīt "šodienas izvēlni" bez skrāpēšanas).
Ja jums kāds no šiem ir nepieciešams ātrāk, rakstiet uz hello@fooodo.com — partneru pieprasījums mēdz tos pavirzīt uz priekšu.
Atlaides, kuponi un lojalitāte
Operatora rokasgrāmata, kā ar Fooodo palīdzību palielināt apmeklētāju plūsmu un vidējo čeku — laika loga atlaides, kuponu kodi, POS virzīta lojalitāte, šķērspārdošana, dzeramnaudas un ziedojumi.
Fooodo Insights
AI lēmumu inteliģences slānis 5–200 vietu restorānu ķēdēm — katrs ieteikums saistīts ar EBIT, cilvēks vienmēr iesaistīts lēmumu pieņemšanā, un sešslāņu arhitektūra aiz tā visa.