API Documentation

Overview

The brim.ro API provides programmatic access to the platform's functionality, allowing developers to integrate our services into their applications. The API is public and does not require API key authentication.

Features

• Location and city discovery
• Artist availability checking
• Reservation management
• Service and pricing information

Rate Limiting

The API has rate limits to ensure service performance and stability. Limits are: 2 requests per second and 60 requests per minute per IP address. For the reservation endpoint, there is an additional limit of maximum 60 open (unused) reservation codes per IP address.

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:

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

Authentication

The API is public and does not require API key authentication. All endpoints are accessible without authentication. For reservations, a unique code system is used, sent via email or SMS.