Rezervari prin API si MCP (AI) in Romania

Prezentare generală

brim.ro oferă două modalități de integrare: API REST public și integrare MCP (Model Context Protocol) pentru asistenți AI. API-ul oferă acces programatic la funcționalitățile platformei, permițând dezvoltatorilor să integreze serviciile noastre în aplicațiile lor. Integrarea MCP permite asistenților AI (precum ChatGPT, Claude, etc.) să facă rezervări direct prin conversație naturală.

Funcționalități

  • Descoperirea locațiilor și orașelor
  • Verificarea disponibilității artiștilor
  • Gestionarea rezervărilor
  • Informații despre servicii și prețuri

Documentație tehnică

Pentru documentația tehnică completă, inclusiv toate endpoint-urile disponibile, parametrii și exemple de răspunsuri, consultă documentația OpenAPI interactivă:

Vezi documentația API

Limitări de rată

API-ul are limitări de rată pentru a asigura performanța și stabilitatea serviciului. Limitele sunt: 2 cereri pe secundă și 60 de cereri pe minut per adresă IP. Pentru endpoint-ul de rezervare, există o limită suplimentară de maximum 60 de coduri de rezervare deschise (neutilizate) per adresă IP.

Integrare MCP pentru Asistenți AI

Model Context Protocol (MCP) este un protocol standard care permite asistenților AI să interacționeze cu serviciile externe. brim.ro oferă suport complet pentru MCP, permițând asistenților AI să:

  • Căuteze locații și servicii de beauty în România
  • Verifice disponibilitatea artiștilor pentru date specifice
  • Creeze rezervări direct prin conversație naturală
  • Gestioneze rezervările existente

Cum funcționează

  1. Asistentul AI primește o cerere de la utilizator (ex: 'Vreau să-mi fac unghiile în Scorteni, Bacau')
  2. Asistentul folosește tool-urile MCP pentru a căuta locații și servicii disponibile
  3. Asistentul verifică disponibilitatea și prezintă opțiunile utilizatorului
  4. După confirmare, asistentul inițiază procesul de rezervare
  5. Un cod de verificare este trimis prin email sau SMS
  6. Utilizatorul confirmă cu codul și rezervarea este finalizată

Endpoint MCP

Endpoint-ul MCP este disponibil la:

https://brim.ro/api/v1/mcp

MCP folosește Server-Sent Events (SSE) pentru comunicare în timp real cu asistenții AI.

Autentificare

API-ul este public și nu necesită autentificare cu chei API. Toate endpoint-urile sunt accesibile fără autentificare. Pentru rezervări, se folosește un sistem de coduri unice trimise prin email sau SMS.