BAS-IP Link API: Cách tích hợp hệ thống kiểm soát ra vào và cửa ra vào

Một cư dân mới trước tiên được thiết lập trong hệ thống mà ban quản lý đã sử dụng cho các căn hộ, cư dân và thông tin liên hệ. Sau đó, cùng một người này lại được tạo một lần nữa, lần này là trong hệ thống chuông cửa (kiểm soát ra vào). Quyền truy cập thay đổi — hai hệ thống cần được cập nhật. Cư dân chuyển đi — hồ sơ phải bị xóa hai lần.

Tại một địa điểm duy nhất, đó đơn giản là công việc quản trị phát sinh thêm. Trên toàn bộ danh mục bất động sản với những người chuyển đến thường xuyên, thay đổi quyền truy cập và thẻ tạm thời, nó trở thành một quy trình quản lý riêng biệt mà ngay từ đầu không ai thực sự mong muốn.

BAS-IP Link và Link API là gì?

BAS-IP Link là nền tảng tập trung của BAS-IP để quản lý các địa điểm, người dùng, quyền truy cập và cơ sở hạ tầng được kết nối.

BAS-IP Link API là một HTTP REST API cho phép hệ thống phía máy chủ của bên thứ ba tương tác với Link theo cách lập trình: truyền dữ liệu người dùng, quản lý quyền và thông tin xác thực truy cập, và trích xuất dữ liệu từ nền tảng.

Mục đích không phải là cung cấp cho nhân viên một hệ thống khác để làm việc. Hoàn toàn ngược lại: nền tảng hiện tại của khách hàng có thể duy trì là giao diện hoạt động chính, trong khi BAS-IP trở thành một phần của các quy trình đã được quản lý ở đó.

Điều này trông như thế nào trong thực tế? Thêm một cư dân mới

Công ty quản lý đã biết tên của cư dân, căn hộ, chi tiết liên hệ và các thông tin liên quan khác. Dữ liệu đó đã tồn tại trong hệ thống riêng của họ.

Nếu không có sự tích hợp, một nhân viên sau đó phải mở BAS-IP Link và tạo lại cùng một người dùng đó.

Với Link API, bước thứ hai đó có thể được tự động hóa. Hệ thống chính truyền dữ liệu cần thiết đến Link, người dùng được đặt vào đúng địa điểm và căn hộ phù hợp, và BAS-IP Link sau đó hoạt động với cơ sở hạ tầng kiểm soát ra vào và chuông cửa được kết nối.

Giá trị thực tế không chỉ đơn giản là hai hệ thống có thể trao đổi dữ liệu. Mà là nhân viên không phải thay đổi cách họ vẫn đang làm việc.

Nếu việc chuyển đến, thay đổi chi tiết cư dân và chuyển đi đã được quản lý trong nền tảng chính, các hành động tương tự không cần phải lặp lại thủ công trong hệ thống chuông cửa.

Tại sao nên sử dụng Link API khi thiết bị BAS-IP có API riêng?

BAS-IP cũng hỗ trợ tích hợp trực tiếp với thiết bị thông qua BAS-IP Device API.

Đối với một dự án cục bộ, đó có thể là cách tiếp cận phù hợp. Nếu một hệ thống cần hoạt động với một hoặc một vài kiểu thiết bị đã biết và chỉ yêu cầu một tập hợp chức năng hạn chế, thì có thể không cần thêm một lớp máy chủ.

Yêu cầu thay đổi khi dự án mở rộng quy mô.

Các tòa nhà khác nhau có thể sử dụng các bảng gọi cửa, màn hình trong nhà và các thiết bị khác nhau. Các mẫu và phiên bản phần mềm cơ sở mới được giới thiệu theo thời gian. Với việc tích hợp thiết bị trực tiếp, nhóm phát triển bên thứ ba cần tính đến các đặc điểm của thiết bị mà họ đang tích hợp.

BAS-IP Link bổ sung một lớp phần mềm tập trung giữa nền tảng của bên thứ ba và cơ sở hạ tầng chuông cửa.

Thay vì xây dựng logic nghiệp vụ xoay quanh một bảng gọi cửa cụ thể, nền tảng bên ngoài hoạt động với mô hình trung tâm của Link gồm người dùng, địa điểm, căn hộ, quyền truy cập và các thực thể khác.

Đó thường là một mô hình tự nhiên hơn đối với một nền tảng quản lý tài sản khu dân cư. Nó thường không cần biết chính xác bảng gọi cửa nào được lắp ở một ô cửa cụ thể. Nó cần biết rằng một cư dân cụ thể thuộc về một căn hộ cụ thể và nên có quyền truy cập vào các khu vực phù hợp.

BAS-IP Link kết nối logic nghiệp vụ đó với cơ sở hạ tầng vật lý của hệ thống chuông cửa và kiểm soát ra vào.

Bạn có thể làm gì thông qua BAS-IP Link API?

Một tích hợp cụ thể thông thường sẽ chỉ sử dụng một phần chức năng có sẵn trong Link.

Thông qua API, hệ thống của bên thứ ba có thể làm việc với:

• người dùng và cấu trúc địa điểm;
• quyền truy cập;
• thông tin xác thực truy cập vĩnh viễn và tạm thời, bao gồm thẻ, fobs (móc khóa), mã PIN, mã QR, Face ID, UKEY và biển số xe;
• quyền truy cập của khách và khách vãng lai;
• tin nhắn và khảo sát;
• số ảo và chuyển tiếp cuộc gọi;
• cấu hình thiết bị từ xa;
• sự kiện và nhật ký (logs).

Tuy nhiên, một dự án tích hợp thường được xác định tốt hơn bằng một câu hỏi khác thay vì “Những phương thức API nào có sẵn?”.

Những công việc nào hiện đang được thực hiện thủ công, và những công việc nào trong số đó sẽ diễn ra tự động sau khi các hệ thống được tích hợp?

Đối với một nền tảng, trường hợp sử dụng chính có thể là quản lý cư dân. Đối với một nền tảng khác, có thể là quyền truy cập tạm thời cho nhà thầu. Một nền tảng thứ ba có thể chủ yếu cần dữ liệu sự kiện.

Quản lý toàn bộ vòng đời người dùng, không chỉ tạo người dùng

Tạo người dùng chỉ là bước đầu tiên.

Khi một cư dân đã được thêm, quyền truy cập và thông tin xác thực phù hợp có thể được gán. Nếu cư dân chuyển đến căn hộ khác, đổi xe, nhận thêm quyền hoặc mất quyền truy cập, những thay đổi đó cũng có thể tạo thành một phần của quy trình làm việc trong nền tảng chính.

Nguyên tắc tương tự cũng áp dụng cho người dùng tạm thời.

Nếu một hệ thống hiện có đã quản lý khách truy cập, nhà thầu hoặc nhân viên dịch vụ, thì không cần phải tạo một quy trình hành chính riêng biệt chỉ dành riêng cho BAS-IP.

Ví dụ, nền tảng chính có thể xác định rằng một nhà thầu sẽ có thể vào tòa nhà vào thứ Ba từ 10:00 đến 14:00. Trong kịch bản đó, BAS-IP trở thành lớp truy cập thực hiện một quy trình đã được xác định ở nơi khác.

Do đó, hệ thống chuông cửa và kiểm soát ra vào trở thành một phần của mô hình hoạt động rộng hơn của tòa nhà thay vì là một hệ thống riêng biệt phải được quản lý độc lập.

Điều gì xảy ra nếu địa điểm đã hoạt động và có một cơ sở người dùng lớn?

Một sự tích hợp không nhất thiết phải bắt đầu với một cơ sở dữ liệu trống.

Nếu một hệ thống hiện tại đã chứa hàng trăm hoặc hàng nghìn cư dân, họ không cần phải được nhập vào BAS-IP Link theo cách thủ công từng người một.

Khi sử dụng BAS-IP Link API, phương thức tạo người dùng có thể thêm nhiều người dùng trong một yêu cầu duy nhất.

Số lượng bản ghi tối đa được đảm bảo trên mỗi thao tác và tần suất cho phép của các yêu cầu liên tiếp hiện không được chỉ định. Do đó, đối với một đợt di chuyển lớn, các tham số này cần được xác thực trong môi trường thử nghiệm của dự án trước khi di chuyển toàn bộ cơ sở người dùng.

Chi tiết triển khai cho phương thức API được cung cấp cho các đối tác tích hợp trong tài liệu kỹ thuật.

Ngoài ra còn có tùy chọn tích hợp sẵn để tạo người dùng hàng loạt mà không cần phát triển tích hợp API.

BAS-IP Link có thể xuất cấu trúc địa điểm sang tệp XLS. Chi tiết người dùng và giấy phép sau đó được hoàn thành trong bảng tính và nhập ngược lại vào Link. Sau khi được nhập, người dùng sẽ tự động được gán vào các nhóm địa điểm được chỉ định. Trong trường hợp có nhiều người dùng thuộc cùng một căn hộ hoặc nhóm địa điểm khác, các hàng riêng biệt có thể sử dụng cùng một mã định danh nhóm.

Đối với việc triển khai khu dân cư ban đầu, không cần thiết phải thu thập địa chỉ email của từng thành viên trong gia đình. Một địa chỉ email cho mỗi căn hộ là đủ: người dùng được mời nhận email, hoàn tất đăng ký và sau đó có thể tự thêm các thành viên trong gia đình.

Do đó, đối với một dự án hiện có, nhóm dự án có thể chọn giữa việc di chuyển API tự động và quy trình tải lên hàng loạt được tích hợp sẵn của Link, tùy thuộc vào kiến trúc hệ thống và nơi lưu trữ cơ sở dữ liệu người dùng nguồn.

Các sự kiện BAS-IP có thể được sử dụng trong một hệ thống khác không?

Có. Dữ liệu và sự kiện được lưu giữ trong Link có thể được sử dụng bởi hệ thống của bên thứ ba.

Ví dụ: một nhóm bảo mật có thể đã làm việc từ một giao diện duy nhất tập hợp thông tin từ hệ thống kiểm soát ra vào, camera quan sát (CCTV) và các hệ thống khác của tòa nhà. Dữ liệu BAS-IP có thể là một phần của cùng quy trình hoạt động đó.

Tuy nhiên, có một sự khác biệt quan trọng về mặt kỹ thuật.

BAS-IP Link hiện không cung cấp webhook để đẩy các sự kiện sang hệ thống của bên thứ ba. Hệ thống bên ngoài trích xuất dữ liệu cần thiết bằng cách tạo các yêu cầu tới Link API.

Nếu một dự án yêu cầu các sự kiện cụ thể được phân phối trực tiếp từ thiết bị qua webhook, kịch bản đó khả dụng trên các bảng gọi cửa dựa trên Android được hỗ trợ thông qua BAS-IP Device API.

Do đó, một dự án có thể kết hợp tích hợp tập trung thông qua Link với khả năng tương tác trực tiếp với các thiết bị được chọn khi cần thiết.

Hệ thống nào nên là nguồn dữ liệu gốc (source of truth)?

Một trong những quyết định quan trọng trong việc tích hợp là hệ thống nào chịu trách nhiệm cho từng loại dữ liệu.

Nếu cùng một người dùng có thể bị thay đổi độc lập trong cả nền tảng quản lý tài sản và BAS-IP Link, thì các bản ghi cuối cùng có thể trở nên không nhất quán.

Ví dụ: nền tảng quản lý tài sản có thể vẫn chịu trách nhiệm về cư dân và căn hộ, BAS-IP Link có thể áp dụng thông tin đó cho hệ thống chuông cửa và kiểm soát ra vào, trong khi một nền tảng bảo mật riêng biệt sử dụng dữ liệu sự kiện mà những người vận hành cần.

Một dự án khác có thể phân chia trách nhiệm theo cách khác.

Điểm quan trọng không phải là BAS-IP, hay nền tảng của bên thứ ba, luôn phải là hệ thống “chủ” (master). Mà là nguồn có thẩm quyền cho từng thực thể và hướng đồng bộ hóa phải được xác định rõ ràng.

Đó là điều giúp loại bỏ việc quản trị trùng lặp thay vì chỉ đơn giản là kết nối hai cơ sở dữ liệu.

Link API hữu ích nhất ở đâu?

Link API đặc biệt phù hợp khi BAS-IP cần trở thành một phần của hệ sinh thái phần mềm hiện có.

Các ví dụ điển hình bao gồm:

• các nền tảng quản lý khu dân cư và bất động sản;
• các hệ thống kiểm soát ra vào quy mô lớn;
• nền tảng BMS và tòa nhà thông minh;
• các sản phẩm PropTech (Công nghệ Bất động sản);
• nền tảng phần mềm riêng của các nhà tích hợp;
• các nền tảng quản lý nhiều tòa nhà hoặc nhiều địa điểm.

Dự án càng có nhiều người dùng, nhiều tòa nhà và sự thay đổi truy cập thường xuyên, thì công việc quản trị càng bị trùng lặp nhiều hơn khi các hệ thống vẫn tách biệt.

Do đó, giá trị của Link API thường không được xác định bởi số lượng phương thức API khả dụng, mà là bởi số lượng các quy trình hoạt động riêng biệt có thể được kết hợp lại với nhau.

Bảo mật và quyền tích hợp

Hệ thống của bên thứ ba không cần quyền truy cập quản trị không hạn chế vào Link.

Trong BAS-IP Link Self-Hosted, một tài khoản tích hợp chuyên dụng có thể được tạo và giới hạn quyền hạn của nó cả theo chức năng và theo từng địa điểm cụ thể.

Ví dụ, một tích hợp được sử dụng bởi một nhà điều hành bất động sản cụ thể có thể được giới hạn ở các tòa nhà do tổ chức đó quản lý.

Việc xác thực sử dụng access tokens (mã thông báo truy cập) và giao tiếp API diễn ra qua HTTPS.

Luồng xác thực chi tiết và cấu trúc yêu cầu được đề cập trong tài liệu kỹ thuật Link API.

BAS-IP Link Self-Hosted và Link Cloud

Tại thời điểm xuất bản bài viết này, các tích hợp phía máy chủ của bên thứ ba thông qua BAS-IP Link API được hỗ trợ trên BAS-IP Link Self-Hosted.

BAS-IP đang phát triển một cổng API (API gateway) riêng cho BAS-IP Link Cloud.

Do đó, nếu một dự án đặc biệt yêu cầu tích hợp bên thứ ba với Link Cloud, kiến trúc đề xuất nên được thảo luận với BAS-IP trước khi bắt đầu phát triển.

Cách bắt đầu tích hợp

Một dự án Link API bắt đầu bằng trường hợp sử dụng (use case) thay vì danh sách các lệnh gọi API.

Ví dụ:

“Khi chúng tôi tạo một cư dân trong nền tảng của mình, chúng tôi muốn người dùng đó được tạo tự động trong địa điểm BAS-IP chính xác.”

Đó là đủ để bắt đầu một cuộc thảo luận về kiến trúc.

Sau khi thống nhất kịch bản tích hợp, đối tác sẽ ký NDA (Thỏa thuận không tiết lộ) và nhận các tài liệu kỹ thuật liên quan.

Bản thân việc tích hợp thường do đội ngũ của đối tác phát triển. Một dự án điển hình thường sẽ yêu cầu một nhà phát triển back-end hoặc full-stack. Các đợt triển khai lớn hơn cũng có thể yêu cầu chuyên môn về DevOps.

Để phát triển và thử nghiệm, BAS-IP Link Self-Hosted có thể được triển khai trong môi trường riêng của đối tác. Hiện tại không có môi trường thử nghiệm công cộng (sandbox) chung cho Link API. Giấy phép kiểm thử và sắp xếp phần cứng được thỏa thuận theo yêu cầu của từng dự án riêng biệt.

BAS-IP cung cấp tài liệu, trả lời các câu hỏi kỹ thuật liên quan đến các sản phẩm của mình và giúp điều tra các trường hợp việc triển khai dựa trên tài liệu nhưng không hoạt động như mong đợi.

Nếu một dự án yêu cầu chức năng hiện không có trong sản phẩm, yêu cầu đó có thể được thảo luận với nhóm sản phẩm. Công việc liên quan và vị trí của nó trong kế hoạch phát triển sẽ được đánh giá trước. Bản thân một đánh giá như vậy không cấu thành một cam kết cho một ngày phát hành cụ thể.

Tích hợp Link API mất bao lâu?

Không có một khoảng thời gian duy nhất nào áp dụng cho mọi dự án.

Đối với một tích hợp tương đối tiêu chuẩn, khoảng một tháng tập trung phát triển có thể được sử dụng như một hướng dẫn chung, mặc dù thời gian theo lịch thường dài hơn.

Nhóm phát triển của đối tác cần thời gian để hiểu mô hình dữ liệu Link, triển khai phần tích hợp của họ, kiểm tra nó và đưa công việc vào lịch trình phát triển riêng của họ.

Do đó, một ước tính có ý nghĩa chỉ có thể được thực hiện sau khi kịch bản tích hợp thực tế đã được xác định.

Có tính thêm phí cho BAS-IP Link API không?

BAS-IP thường không tính phí riêng cho việc truy cập vào tài liệu và các công cụ tích hợp.

Bản thân BAS-IP Link được cấp phép theo mô hình cấp phép sản phẩm tiêu chuẩn. Đối tác phát triển phía tích hợp của riêng họ, trong khi các công việc phát triển BAS-IP phi tiêu chuẩn hoặc các yêu cầu thay đổi mức độ ưu tiên của công việc đó có thể được thảo luận riêng khi cần thiết.

Vì lý do đó, việc mô tả bản thân việc tích hợp là “miễn phí” có thể gây hiểu nhầm.

Một tuyên bố chính xác hơn là thường không có phí riêng cho việc truy cập vào các công cụ tích hợp của BAS-IP.

Khi nào Link API không phải là cách tiếp cận đúng đắn?

Link API chủ yếu nhằm mục đích tích hợp phía máy chủ với BAS-IP Link.

Nếu yêu cầu là làm việc trực tiếp với thiết bị cụ thể, hoặc để nhận các sự kiện cụ thể trực tiếp từ bảng gọi cửa, thì BAS-IP Device API có thể phù hợp hơn. Tài liệu tích hợp thiết bị có sẵn thông qua cổng thông tin dành cho nhà phát triển công khai của BAS-IP.

Nếu một tổ chức đã có ứng dụng di động riêng và muốn thêm chức năng gọi cửa, video và mở cửa vào trong ứng dụng đó, thì BAS-IP Mobile SDK được thiết kế cho trường hợp sử dụng đó.

Và khi khả năng tương tác tiêu chuẩn thông qua SIP, RTSP hoặc Wiegand là đủ, thì có thể không cần đến việc tích hợp phần mềm tùy chỉnh.

Các cách tiếp cận khác nhau được đề cập chi tiết hơn trong “Tích hợp Hệ thống chuông cửa IP BAS-IP với Hệ thống Tòa nhà Hiện có”.

Câu hỏi thường gặp

BAS-IP Link API có phải là REST API không?

Có. BAS-IP Link API là một HTTP REST API cho phép hệ thống phía máy chủ của bên thứ ba tương tác theo cách lập trình với BAS-IP Link.

Tôi có cần BAS-IP Link để sử dụng Link API không?

Có. Link API là giao diện lập trình cho nền tảng BAS-IP Link.

BAS-IP Link API có hoạt động với Link Cloud không?

Tại thời điểm xuất bản, các tích hợp phía máy chủ của bên thứ ba thông qua Link API được hỗ trợ trên BAS-IP Link Self-Hosted. BAS-IP đang phát triển một cổng API riêng cho Link Cloud.

Tôi có thể lấy tài liệu bằng cách nào, và có cần NDA không?

Trường hợp sử dụng tích hợp được thống nhất trước tiên. Sau đó, đối tác ký NDA và nhận các tài liệu kỹ thuật liên quan đến Link API.

Sự khác biệt giữa Link API và Mobile SDK là gì?

Link API nhằm mục đích tích hợp phía máy chủ với BAS-IP Link, bao gồm người dùng, địa điểm, quyền truy cập và các thực thể nền tảng tập trung khác.

BAS-IP Mobile SDK phục vụ một mục đích khác: thêm chức năng chuông cửa trực tiếp vào một ứng dụng di động hiện có.

Cả hai có thể được sử dụng trong cùng một dự án nếu cần thiết.

Bạn muốn tích hợp nền tảng của mình với BAS-IP Link?

Bạn không cần phải chuẩn bị đặc tả API chi tiết trước cuộc thảo luận đầu tiên.

Hãy bắt đầu bằng cách mô tả hệ thống bạn đã có và quy trình bạn muốn tự động hóa.

Ví dụ:

“Chúng tôi tạo cư dân trong nền tảng của riêng mình và muốn họ được tự động chuyển sang BAS-IP.”

hoặc:

“Chúng tôi quản lý quyền truy cập của khách truy cập trong hệ thống của riêng mình và muốn kết nối quy trình đó với BAS-IP.”

Đội ngũ BAS-IP có thể giúp xác định xem Link API có phải là cách tiếp cận đúng đắn hay không, những khả năng nền tảng nào sẽ được yêu cầu và kiến trúc tích hợp nên được cấu trúc như thế nào.