开放平台

APP Integration Development Guide

1.1 Overview

Orbita IOT is a door lock product that combines software and hardware with completely independent intellectual property rights. It uses a mobile APP to replace traditional keys for door opening.

To meet the customized needs of partner systems, Orbit provides an open platform with Open API and APP SDK. Partners can conveniently integrate various functions of Orbit IOT into their own application systems and APPs. This document explains the integration development of the APP.

1.2 Integration

The integration is shown in the following diagram.

Bluetooth Integration: The mobile phone calls the API to communicate with the lock via Bluetooth to realize functions such as unlocking the lock.
Card Function Integration: The third - party application system realizes card issuance through the SDK provided by the Orbit platform and unlocks via the card.

1.3 Development Steps

(1) Register as a developer (Management Center --> Registration) and wait for approval.

(2) Create an application and verify the hotel's SN.

(3) Obtain hotel authorization.

(4) Once authorized, receive the client_id and client_secret to obtain an access token.

(5) Use the access token to call relevant APIs. Refer to the subsequent application process for details.

1.3 Application Process

a. Bluetooth Unlocking & Power Switch Power On/Off Process

Broadcast prefix: OBT Service UUID: FFF0 Write Characteristic UUID: FFF1 Notify Characteristic UUID: FFF4

User Operation → Permission Verification → Device Scanning (Obtain MAC address and TID via Get "Obtain Room List") → Device Connection → Service Discovery (FFF0) → Enable Notification (FFF4) → Send Unlock Command (Acquire binary data in advance via Get "Obtain Guest Bluetooth Unlocking Command\Obtain Staff Bluetooth Unlocking Command") → Write Command Data → Monitor Response (Bluetooth Unlock Data Packet Callback) → Process Execution Result

b. Bluetooth Elevator Access Process

User Operation → Permission Verification → Obtain Building Data (Get building ID " via Get Building List or Get Guest Authorized Elevator List") → Acquire Elevator BLE Broadcast Data (via "Get Staff Elevator BLE Broadcast Data or Get Guest Elevator BLE Broadcast Data") → Start BLE Broadcast (Broadcast the acquired data as device broadcast name) → Elevator Receives Broadcast Data → Stop Broadcast