توثيق الـ API

{
  "username": "manager@hotel.sa",
  "password": "••••••••",
  "client_id": "00001"  // رقم المنشأة
}

{
  "status": "ok",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expires_at": "2026-06-03T12:00:00Z",
  "user": {
    "id": 42,
    "name": "سارة أحمد",
    "role": "manager",
    "client_id": "00001"
  }
}

// لا يحتاج body — يستخدم Bearer token في الـ header
Authorization: Bearer <token>

{
  "status": "ok",
  "message": "Logged out successfully"
}

GET https://api.dheuof.com/v1/api/status
Authorization: Bearer <token>

{
  "authenticated": true,
  "user_id": 42,
  "client_id": "00001",
  "expires_at": "2026-06-03T12:00:00Z"
}

GET https://api.dheuof.com/v1/api/guests?limit=20&offset=0&search=أحمد

{
  "total": 142,
  "limit": 20,
  "offset": 0,
  "data": [
    {
      "id": 1,
      "name": "أحمد محمد الغامدي",
      "email": "ahmed@example.com",
      "phone": "+966501234567",
      "nationality": "SA",
      "id_number": "1xxxxxxxxx",
      "created_at": "2026-01-15T08:00:00Z"
    }
  ]
}

{
  "name": "فاطمة العتيبي",              // مطلوب
  "email": "fatima@example.com",
  "phone": "+966509876543",             // مطلوب
  "nationality": "SA",
  "id_number": "1xxxxxxxxx",
  "id_type": "national_id",             // national_id | passport | iqama
  "notes": "ضيف VIP"
}

{
  "id": 201,
  "name": "فاطمة العتيبي",
  "created_at": "2026-06-02T10:00:00Z"
}

GET https://api.dheuof.com/v1/api/bookings?status=confirmed&from=2026-06-01&to=2026-06-30

{
  "total": 38,
  "data": [
    {
      "id": "BK-20260601-001",
      "guest_id": 1,
      "room_id": 105,
      "check_in": "2026-06-10",
      "check_out": "2026-06-14",
      "status": "confirmed",
      "channel": "direct",
      "total_amount": 1400.00,
      "currency": "SAR"
    }
  ]
}

{
  "guest_id": 1,
  "room_id": 105,
  "check_in": "2026-06-10",
  "check_out": "2026-06-14",
  "adults": 2,
  "children": 0,
  "channel": "direct",
  "notes": "طلب غرفة هادئة"
}

{
  "id": "BK-20260602-002",
  "status": "confirmed",
  "total_amount": 1400.00,
  "created_at": "2026-06-02T11:30:00Z"
}

// PUT /api/bookings/BK-20260601-001
{
  "check_out": "2026-06-16",      // تمديد الإقامة
  "status": "confirmed",
  "notes": "تم التمديد بطلب الضيف"
}

{
  "id": "BK-20260601-001",
  "status": "confirmed",
  "check_out": "2026-06-16",
  "updated_at": "2026-06-02T12:00:00Z"
}

GET https://api.dheuof.com/v1/api/rooms

{
  "total": 24,
  "data": [
    {
      "id": 101,
      "number": "101",
      "type": "standard",
      "floor": 1,
      "max_occupancy": 2,
      "base_price": 350.00,
      "currency": "SAR",
      "status": "available"
    }
  ]
}

GET https://api.dheuof.com/v1/api/rooms/availability?check_in=2026-06-10&check_out=2026-06-14

{
  "check_in": "2026-06-10",
  "check_out": "2026-06-14",
  "available": [
    {
      "room_id": 103,
      "type": "deluxe",
      "price_per_night": 480.00,
      "total": 1920.00
    }
  ]
}

{
  "event": "booking.new",
  "booking_id": "BCOM-9876543",
  "property_id": "00001",
  "check_in": "2026-06-15",
  "check_out": "2026-06-18",
  "guest_name": "John Smith",
  "room_type": "standard",
  "total_amount": 1050.00,
  "currency": "SAR"
}

{
  "received": true,
  "booking_ref": "BK-20260602-003",
  "synced": true
}

GET https://api.dheuof.com/v1/api/channels/status/00001

{
  "client_id": "00001",
  "channels": [
    { "name": "booking_com",  "status": "connected", "last_sync": "2026-06-02T08:00:00Z" },
    { "name": "airbnb",       "status": "connected", "last_sync": "2026-06-02T07:45:00Z" },
    { "name": "expedia",      "status": "disconnected", "last_sync": null }
  ]
}

GET https://api.dheuof.com/v1/api/invoices?limit=10&status=paid

{
  "total": 87,
  "data": [
    {
      "id": "INV-2026060001",
      "booking_id": "BK-20260601-001",
      "amount": 1400.00,
      "vat": 210.00,
      "total": 1610.00,
      "status": "paid",
      "zatca_uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "pdf_url": "https://api.dheuof.com/v1/invoices/INV-2026060001.pdf"
    }
  ]
}

{
  "booking_id": "BK-20260601-001",
  "amount": 1400.00,
  "currency": "SAR",
  "include_vat": true,
  "send_email": true,
  "send_whatsapp": false
}

{
  "id": "INV-2026060002",
  "status": "issued",
  "zatca_status": "submitted",
  "pdf_url": "https://api.dheuof.com/v1/invoices/INV-2026060002.pdf",
  "created_at": "2026-06-02T12:00:00Z"
}