ket-noi-api-pms

Với việc sử dụng API PMS skyhotel (API PMS), bạn có thể truy vấn phòng trống (Availability) và tạo đặt phòng từ APP hoặc Website của khách sạn

Để sử dụng được API PMS, bạn cần thực hiện các bước sau:

1. Tạo tài khoản API

Tài khoản API để sử dụng trong code API. Để tạo tài khoản API, bạn đăng nhập vào tài khoản Full Admin skyhotel. Sau đó vào mục: Nhân viên > Quản lý Nhân viên > Thêm > Tạo tk nhân viên với phần quyền API_USER (Phân quyền này có sẵn cho các tk admin khi đăng ký sử dụng API):

2. Tải file mẫu API

Tải file mẫu sử PHP tại: https://skyhotel.vn/files/test_api.zip

Các ngôn ngữ lập trình khác. Vui lòng tham chiếu request từ mã CURL trong file PHP test ở trên

3. Cách chạy API

Mỗi request API sẽ kèm theo thông số username và password được tạo ở bước 1

Trong API có 3 hàm chính:

1. get_hotels

Để lấy danh sách khách sạn của user api. Kết quả trả về là một mảng danh sách khách sạn gồm: hotel_id và hotel_name. Ví dụ

{
    "hotels": [
        {
            "hotel_id": 9460,
            "hotel_name": "Bình An Hotel"
        }, {
            "hotel_id": 9461,
            "hotel_name": "Khánh Linh Hotel"
        }
    ]
}

2. get_availability

Dùng để truy vấn phòng trống trong khoản thời gian. Kết quả trả về:

{
  "room_types": [
    {
      "room_type_id": "27707",
      "room_type_name": "STANDARD",
      "availability": 6,
      "rates": [
        {
          "date": "2024-06-16",
          "rate": 1818000
        },
        {
          "date": "2024-06-17",
          "rate": 1818000
        },
        {
          "date": "2024-06-18",
          "rate": 1818000
        }
      ]
    },
    {
      "room_type_id": "27709",
      "room_type_name": "DOUBLE",
      "availability": 14,
      "rates": [
        {
          "date": "2024-06-16",
          "rate": 2020000
        },
        {
          "date": "2024-06-17",
          "rate": 2020000
        },
        {
          "date": "2024-06-18",
          "rate": 2020000
        }
      ]
    },
    {
      "room_type_id": "27710",
      "room_type_name": "TWIN",
      "availability": 7,
      "rates": [
        {
          "date": "2024-06-16",
          "rate": 3188000
        },
        {
          "date": "2024-06-17",
          "rate": 3188000
        },
        {
          "date": "2024-06-18",
          "rate": 3188000
        }
      ]
    }
  ]
}

3. push_booking

Dùng để tạo booking trên PMS. Kết quả trả về là mã booking thành công trên PMS

{
    "result": {
        "code_book": 4,
        "id": 501053303
    }
}