Documentație API

Integrează-te cu sistemul folosind API-ul nostru REST

Atenție: API-ul este în dezvoltare și necesită activarea Backend Functions din setări. Pentru conectare reală cu Booking.com și Airbnb, contactează echipa de suport.

Autentificare

Toate cererile necesită un token de autentificare

Authorization: Bearer YOUR_API_TOKEN

Token-ul se obține din Setări → API → Generează Token

GET

/api/v1/availability

Obține disponibilitatea camerelor

Query Parameters:

start_date: string (YYYY-MM-DD)
end_date: string (YYYY-MM-DD)
room_type?: string (optional)

Răspuns:

{
  "available_rooms": [
    {
      "id": "room_123",
      "name": "Camera 101",
      "type": "double",
      "base_price": 65,
      "max_occupancy": 2
    }
  ],
  "occupied_rooms": [
    {
      "id": "room_124",
      "reserved_until": "2025-01-20"
    }
  ]
}

POST

/api/v1/reservations

Creează o rezervare nouă

Request Body:

{
  "room_id": "room_123",
  "guest_name": "Ion Popescu",
  "guest_email": "ion@email.com",
  "guest_phone": "+40 722 123 456",
  "check_in": "2025-01-15",
  "check_out": "2025-01-18",
  "adults": 2,
  "children": 0,
  "total_price": 195,
  "channel": "direct"
}

Răspuns (201 Created):

{
  "id": "res_456",
  "confirmation_code": "ABC123",
  "status": "confirmed",
  "created_at": "2025-01-13T10:00:00Z"
}

GET

/api/v1/reservations/:id

Obține detalii despre o rezervare

Răspuns:

{
  "id": "res_456",
  "room_id": "room_123",
  "guest_name": "Ion Popescu",
  "check_in": "2025-01-15",
  "check_out": "2025-01-18",
  "status": "confirmed",
  "total_price": 195
}

PATCH

/api/v1/reservations/:id

Actualizează statusul unei rezervări

Request Body:

{
  "status": "checked_in"
}

Integrare Booking.com & Airbnb

Pentru conectare bidirecțională reală cu Booking.com și Airbnb:

Activează Backend Functions din Setări
Obține credențiale API de la Booking Extranet și Airbnb Partner Portal
Configurează webhook-uri pentru sincronizare automată
Conectează din secțiunea Canale

După conectare, toate rezervările, anulările și modificările se sincronizează automat în timp real. Sistemul previne overbooking-ul prin blocare instantanee pe toate canalele.

Funcționalități disponibile după conectare:

✓ Sincronizare bidirecțională disponibilitate
✓ Actualizare automată tarife
✓ Import automat rezervări noi
✓ Notificări instant pentru modificări
✓ Prevenire overbooking în timp real

Rate Limits

• Maxim 100 cereri/minut per API key
• Maxim 1000 cereri/oră per API key
• Header-ul X-RateLimit-Remaining indică cererile rămase