Suprafața API și de integrare
Cum integrează partenerii și dezvoltatorii cu Fooodo — serverul MCP public, conectorul POS și contractele white-label, ce este deschis față de ce este închis în prezent și foaia de parcurs pentru integrare.
Suprafața publică de integrare a Fooodo este mică și bine delimitată. Această pagină documentează ce este deschis în prezent, ce este închis și ce se află pe foaia de parcurs.
Ce este deschis în prezent
Serverul MCP
Fooodo rulează un server Model Context Protocol (MCP) la /api/mcp pentru ca agenții AI să poată interoga manualul și să efectueze un număr limitat de acțiuni delimitate în numele unui cumpărător. Agenții citesc manualul fără a extrage HTML și trimit cereri structurate fără a completa formulare HTML — astfel, asistenții de suport pentru parteneri, copiloții de definire a domeniului de integrare și agenții de achiziții din partea cumpărătorului rămân ancorați în date canonice și ajung la căsuța de e-mail potrivită.
# Connect from Claude Desktop, Cursor, or any MCP-compatible client:
mcp connect https://fooodo.com/api/mcpInstrumente de citire (fără efecte secundare):
| Instrument | Returnează |
|---|---|
list_docs | Fiecare pagină din manual cu slug, titlu și o descriere pe un rând. |
get_doc({ slug }) | Conținutul MDX procesat al unei singure pagini. |
search_docs({ query }) | Căutare prin subșir în titluri, descrieri și corpuri, cu un fragment în jurul fiecărei potriviri. |
list_pos_connectors | Conectorii POS activi și politica de definire a domeniului per client pentru restul. |
get_pricing_scope({ locations?, region? }) | Modelul de angajament (abonament per locație, EUR), indicatori de segment (Insights inclus de la 5+ locații, Enterprise de la 150+) și un verdict de potrivire pentru datele introduse de cumpărător. Nu returnează un preț — platforma este cotată per client; acest instrument returnează forma angajamentului pentru ca agentul cumpărătorului să poată califica înainte de a solicita o ofertă. |
Instrument de acțiune (trimite un e-mail echipei Fooodo):
| Instrument | Acțiune |
|---|---|
request_walkthrough({ name, email, variant?, company?, role?, locations?, message?, locale?, agent_origin? }) | Trimite un e-mail de tip lead către operațiuni în numele cumpărătorului pe care îl reprezintă agentul. Răspunsurile ajung la email în termen de două zile lucrătoare. variant are valoarea implicită demo; transmiteți pricing pentru o ofertă, partner pentru interes de revânzare, developer pentru definirea domeniului de integrare API/MCP. agent_origin este afișat în e-mail pentru ca operațiunile să poată tria lead-urile generate de agenți separat de trimiterile prin formular. |
Instrumentul de acțiune este limitat ca rată per e-mail de cumpărător (3 pe oră), iar întreaga suprafață MCP este limitată ca rată per IP (60 de apeluri pe minut). E-mailurile de tip lead sunt direcționate implicit către info@fooodo.com.
Serverul MCP Insights (per-tenant)
Un server MCP separat este livrat împreună cu fiecare tenant Fooodo Insights. În timp ce serverul MCP al manualului de mai sus expune conținutul public al Fooodo și acțiunea de captare a lead-urilor, serverul MCP Insights expune analizele operaționale proprii ale acelui tenant — rezumate de perioadă, performanța canalelor și produselor, date P&L, trei agenți AI specialiști, orchestratorul inter-domenii și un set delimitat de acțiuni de scriere precum declanșare import date și rezolvare alertă.
Serverul utilizează OAuth 2.1 cu Înregistrare Dinamică a Clienților prin Streamable HTTP, astfel încât orice client compatibil MCP se conectează cu același flux într-un singur clic. Funcționalitatea este dezactivată implicit per organizație; activarea și provizionarea URL-ului de tenant se realizează prin support@fooodo.com. Inventarul complet al instrumentelor, configurarea per client și detaliile de securitate: Serverul MCP Insights.
Index de site prietenos cu LLM
/llms.txt oferă un index plat și structurat al fiecărei pagini publice de pe site-ul de marketing și din manual. /llms-full.txt este același manual concatenat ca un singur document Markdown pentru ingestie într-un singur pas. Ambele reprezintă punctele de intrare canonice dacă direcționați un LLM către Fooodo.
Sitemap și Open Graph
Suprafețe standard — /sitemap.xml acoperă toate cele 7 locale de marketing × rutele publice. Imaginile Open Graph și Twitter Card sunt generate per locale.
Ce este închis în prezent
API-ul de comenzi al aplicației de meniu și API-ul de plăți al serviciului de plăți nu sunt publice. Acestea rulează pe infrastructura operată pentru partenerii noștri de implementare, securizată cu credențiale per partener emise în timpul procesului de onboarding.
Dacă sunteți un furnizor POS care dorește să se integreze cu Fooodo, scrieți la hello@fooodo.com — calea de integrare este astăzi manuală, nu self-service.
Cu ce integrează efectiv partenerii
Formele de integrare existente în prezent, în ordinea numărului de parteneri care le utilizează:
Conector POS (back-end)
Cea mai solicitată integrare. Un nou conector POS implementează același contract de intrare și ieșire pe care îl utilizează R-Keeper (consultați Integrarea R-Keeper). Conectorul este un pachet Laravel adăugat la aplicația de meniu — nu este un proces separat.
Suprafața necesară:
- Preluare meniu (produse, categorii, modificatori, prețuri, indicatori fiscali)
- Trimitere comandă (creare, actualizare, blocare, marcare ca plătită)
- Stare (restaurant online/offline, starea mesei)
R-Keeper este singurul conector activ în producție în prezent. Contractul conectorului în sine este agnostic față de POS — conectorii POS suplimentari sunt definiți per client și cotați la cerere. Dacă sunteți un furnizor POS interesat să colaborați la un conector, vă rugăm să ne contactați la partners@fooodo.com.
Implementare white-label (front-end)
Unii revânzători rulează o implementare Fooodo sub propriul brand. Aplicația orientată către client suportă configurarea brandului la nivel de companie: logo, token-uri de culoare, domeniu, branding de plată. Aceasta este o suprafață de configurare, nu un API.
Widget-uri încorporate (ușoare)
Widget-ul AI Ask de pe acest site poate fi încorporat în site-urile partenerilor cu un singur tag de script. Alte widget-uri (previzualizare meniu, disponibilitate masă) nu sunt încă livrate, dar se află pe foaia de parcurs.
Autentificare și secrete
Când partenerii obțin acces la API (pachete de conector POS, implementări white-label), autentificarea se face prin token bearer. Secretele sunt emise per mediu; staging și producție utilizează token-uri separate. Nu există un flux OAuth în prezent — publicul care utilizează API-ul este prea mic pentru a-l justifica.
Webhook-uri (primite, pentru parteneri) — planificate
Pentru implementările partenerilor, webhook-urile de ieșire pentru evenimentele de comandă se află pe foaia de parcurs de integrare. Setul de evenimente planificat:
order.createdorder.paidorder.cancelledorder.errored
Evenimentele interne care stau la baza acestora există deja pe partea aplicației de meniu; dispatcherul de ieșire este configurat per partener în timpul onboarding-ului, mai degrabă decât să ruleze ca un serviciu implicit. Dacă aveți nevoie de push de evenimente ca parte a integrării tale, ridicați această problemă în timpul definirii domeniului — o adăugăm la implementarea ta ca modul opțional.
Versionare
API-urile interne nu au versiuni — aplicația de meniu și serviciul de plăți se implementează împreună pentru Čili Pizza. Odată ce partenerii externi utilizează API-ul, vom introduce etichete de versiune. Nu am ajuns încă în acel punct.
Limite de rată
API-urile publice ale site-ului de marketing (/api/ask, /api/mcp) sunt limitate ca rată per IP. Limitele nu sunt publicate în prezent; sunt dimensionate pentru utilizarea normală a partenerilor și vor fi relaxate pentru partenerii cu un acord.
Foaie de parcurs
În ordinea aproximativă a priorității:
- Un al doilea conector POS — definit per client atunci când un lanț se angajează la acesta.
- Un SDK JS tipizat pentru fluxul de încorporare white-label.
- Un API public read-only pentru interogări de meniu (astfel încât site-urile partenerilor să poată afișa „meniul de astăzi" fără a extrage HTML).
Dacă aveți nevoie de oricare dintre acestea mai devreme, trimiteți un e-mail la hello@fooodo.com — solicitările partenerilor tind să le avanseze în prioritate.
Reduceri, cupoane și fidelizare
Ghidul operatorului pentru atragerea traficului și creșterea valorii medii a comenzii prin Fooodo — reduceri pe ferestre de timp, coduri de cupoane, fidelizare prin POS, vânzări încrucișate la checkout, bacșișuri și donații.
Fooodo Insights
Stratul AI de inteligență decizională pentru lanțuri de restaurante cu 5–200 de locații — care leagă fiecare recomandare de EBIT, menține oamenii în buclă și arhitectura pe șase niveluri din spatele acestuia.