REST / HTTPS
Phong cách API thống nhất cho cloud và gateway cục bộ; trao đổi dữ liệu JSON
Quay lại Giải pháp
Nền tảng API cho nhà phát triển
Mô hình thiết bị chuẩn và giao diện REST cho PMS và hệ thống bên thứ ba.
Nền tảng nhà phát triển Điểm Thuần Thông Minh cung cấp RESTful API chuẩn hóa và SDK mở cho integrator, nhà cung cấp PMS/CRS và ISV — bao gồm onboarding thiết bị, trạng thái phòng, điều khiển cảnh, dữ liệu năng lượng và đăng ký sự kiện. Qua cloud hoặc gateway cục bộ, tích hợp nhanh điều khiển phòng khách Điểm Thuần Thông Minh vào vận hành khách sạn và hệ thống quản lý tòa nhà.
Tải SDK & tài liệu · Nền tảng quản lý cloud · Yêu cầu API keys
Khả năng nền tảng
-
RESTful API
Yêu cầu/phản hồi JSON qua HTTPS, đường dẫn có phiên bản — tích hợp dễ cho front-end, back-end và hệ thống bên thứ ba.
-
SDK đa ngôn ngữ
Mẫu Java, Python và Node.js cùng tiện ích ký để rút ngắn chu kỳ tích hợp và go-live.
-
Sự kiện Webhook
Thay đổi trạng thái phòng, cảnh báo và kết quả cảnh được đẩy chủ động — có retry và xác minh chữ ký.
-
Sandbox
Tenant thử nghiệm riêng và thiết bị mô phỏng cho tích hợp trước production và xác thực tải (đăng ký để kích hoạt).
Module API
Giao diện nhóm theo miền nghiệp vụ với ủy quyền theo phạm vi; định nghĩa trường và giới hạn tốc độ theo tài liệu chính thức.
-
Thiết bị & điểm
Truy vấn trạng thái online RCU, panel và cảm biến; đọc/ghi giá trị điểm, I/O số và analog.
-
Phòng & trạng thái
Đồng bộ check-in/out, DND, MUR, SOS và trạng thái phòng khác; ánh xạ số phòng PMS.
-
Cảnh & liên kết
Kích hoạt chào mừng, tắt điện khi trống, chế độ họp và cảnh khác; truy vấn kết quả và lý do lỗi.
-
Năng lượng & báo cáo
Tổng hợp dữ liệu điện và HVAC theo phòng, tầng hoặc khu vực công cộng; xuất giao diện báo cáo.
-
Cảnh báo & vận hành
Đăng ký cảnh báo thiết bị offline, lỗi truyền thông và tải; tích hợp hệ thống ticket.
-
Dự án & truy cập
Cô lập tenant đa khách sạn/dự án; quản lý AppKey, vai trò và phạm vi API.
Bắt đầu nhanh
-
Đăng ký tài khoản nhà phát triển
Gửi yêu cầu tích hợp qua kinh doanh hoặc hỗ trợ để nhận AppKey / AppSecret.
-
Cấu hình URL callback
Đăng ký URL Webhook trong console nhà phát triển cho sự kiện trạng thái phòng và cảnh báo.
-
Tích hợp sandbox
Gọi API với ID dự án thử nghiệm để xác minh ký, auth và trường nghiệp vụ.
-
Go-live production
Sau nghiệm thu, chuyển sang credentials production và giám sát khối lượng gọi và tỷ lệ lỗi theo SLA.
Endpoint thường dùng
Ví dụ đường dẫn REST điển hình; tải spec OpenAPI đầy đủ từ trung tâm tải xuống.
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
| POST | /v1/oauth/token | Lấy access token (Client Credentials) |
| GET | /v1/projects/{id}/rooms | Danh sách phòng phân trang với tóm tắt trạng thái |
| GET | /v1/projects/{id}/rooms/{roomNo}/devices | Thiết bị và trạng thái online của phòng |
| PUT | /v1/projects/{id}/rooms/{roomNo}/scene/{sceneId} | Kích hoạt cảnh (vd. chào mừng, tắt điện khi trống) |
| POST | /v1/projects/{id}/rooms/{roomNo}/points | Ghi hàng loạt điểm (công tắc, dimming, setpoint HVAC, v.v.) |
| GET | /v1/projects/{id}/energy/summary | Tóm tắt năng lượng theo khoảng thời gian |
| POST | /v1/webhooks/subscriptions | Đăng ký Webhook (trạng thái phòng, cảnh báo, v.v.) |
Giao thức & hệ sinh thái
Ngoài HTTP API, hỗ trợ field bus và nền tảng bên thứ ba cho tích hợp khách sạn và tòa nhà đa dạng.
BACnet / Modbus
Chuyển đổi giao thức cho BMS, HVAC, đồng hồ và subsystem khác
MQTT
Báo cáo thiết bị và gửi lệnh trong kịch bản băng thông thấp
KNX / plugin hệ sinh thái
Làm việc với KNX, Home Assistant và giải pháp kết nối khác
Quy trình onboarding
Gửi yêu cầu
Mô tả kịch bản tích hợp, khối lượng gọi dự kiến và thời gian go-live
Cấp credentials
Gán khóa môi trường sandbox và production
Kiểm thử tích hợp
Hỗ trợ kỹ thuật hỗ trợ kiểm thử API và Webhook
Triển khai chính thức
Chuyển production và đưa vào giám sát vận hành
Câu hỏi thường gặp
Lấy API keys như thế nào?
Dành cho integrator ký hợp đồng và khách hàng chiến lược. Gửi tóm tắt tích hợp qua kinh doanh hoặc hỗ trợ; sau phê duyệt tạo app trong console nhà phát triển để nhận AppKey và AppSecret.
Có hỗ trợ triển khai gateway cục bộ không?
Có. Tập đoàn khách sạn lớn dùng edge gateway cục bộ với API nhất quán cloud trong kịch bản offline và độ trễ thấp; kiến trúc xác định theo dự án.
Có giới hạn tốc độ không?
QPS mặc định và hạn mức hàng ngày theo app; dự án lớn có thể yêu cầu tăng. Vượt giới hạn trả 429 — triển khai exponential backoff.
Webhook bảo mật thế nào?
Payload sự kiện có chữ ký HMAC và timestamp; xác minh chữ ký và từ chối yêu cầu cũ. Dùng endpoint HTTPS; danh sách IP theo yêu cầu.
Khác gì với nền tảng cloud?
Nền tảng cloud là ops trực quan cho nhân viên; API nhà phát triển cho tích hợp hệ thống và tự động hóa — PMS, CRM, nền tảng năng lượng, v.v. Dùng cùng nhau được.
Cần đào tạo tại chỗ hoặc hỗ trợ sau bán hàng?
Chúng tôi cung cấp đào tạo tích hợp API, huấn luyện nghiệm thu dự án và hỗ trợ kỹ thuật toàn vòng đời.
