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 šobrīd ir atvērts un kas slēgts, kā arī integrācijas attīstības plāns.
Fooodo publiskā integrācijas virsma ir neliela un fokusēta. Šī lapa dokumentē to, kas šobrīd ir atvērts, kas ir slēgts un kas ir attīstības plānā.
Kas šobrīd 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 balstās uz kanoniskiem datiem 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 rādītājus (Insights iekļauts no 5+ atrašanās vietām, Enterprise no 150+) un piemērotības vērtējumu pircēja ievaddatiem. 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 | Darbība |
|---|---|
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 saņemtas 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 nomniekam)
Atsevišķs MCP serveris tiek piegādāts ar katru Fooodo Insights nomnieku. 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ā nomnieka pašu darbības analītiku — perioda kopsavilkumus, kanālu un produktu 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 vienu klikšķi. Funkcija pēc noklusējuma ir deaktivizēta katrai organizācijai; aktivizēšana un nomnieka 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, 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 šobrīd ir slēgts
Izvēlnes lietotnes pasūtījumu API un maksājumu pakalpojuma maksājumu API nav publiski. Tie darbojas uz infrastruktūras, ko pārvalda mūsu izvietošanas partneri, un ir aizsargāti 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ļš šobrīd ir individuāls, nevis pašapkalpošanās.
Ar ko partneri faktiski integrējas
Šobrīd 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 šobrīd 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ē, lūdzu, 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 redzamā 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 attīstības plānā.
Autentifikācija un noslēpumi
Kad partneri iegūst API piekļuvi (POS savienotāju pakotnes, white-label izvietošanas), autentifikācija notiek ar nesēja marķieri. Noslēpumi tiek izsniegti katrai videi; testēšanas un ražošanas vides izmanto atsevišķus marķierus. Šobrīd nav OAuth plūsmas — API izmantojošā auditorija ir pārāk maza, lai to pamatotu.
Tīmekļa āķi (ienākoši, partneriem) — plānots
Partneru izvietošanām izejošie tīmekļa āķi pasūtījumu notikumiem ir integrācijas attīstības plānā. 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žojumi 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 līgumu.
Attīstības plāns
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 rā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 vadīta lojalitāte, norēķinu šķērstirgoš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 procesā, un sešslāņu arhitektūra aiz tā visa.