API

该教程面向基于IPS Tools软件的API接口做后台业务功能的软件集成商。通过API接口可获得Anchor、Tag设备的UID、坐标、电量、工作状态以及Tag的实时定位等信息，数据格式为JSON，接口协议包括MQTT、UDP、webhook、HTTP等，软件支持部署在Ubuntu、Windows、MacOs等平台。

1.数据格式：JSON

定位数据示例：

{
    "data": {
        "mapId": 2, // 定位所在楼层id
        "pos": [
            -3.2616942,
            4.3123593,
            1.1999172
        ], // 定位：x,y,z
        "noiseRadius": 0.085815825, // 定位噪声, 值越大置信度越低。
        "posVar": [
            0.71,
            0.62,
            0.03
        ],// x,y,z方向的定位噪声, 值越大置信度越低。
        "time": 1731034496, // 定位unix时间戳.
        "vel": [
            -0.08,
            0.1,
            0
        ], //速度：x,y,z
        "velVar": [
            0.13,
            0.13,
            0.01
        ], //x,y,z方向的速度噪声, 值越大置信度越低。
        "properties": {
        	"tansmit": "xxxxxxxxxxxx"  // 透传数据，base64编码。
    	},
        "rxAnchorSn": "1e00400007503148", // 最强接收信号对应基站UID
        "rxRssi": -47.235565185546875 // 最强接收信号
    },
    "deviceName": "T4", // 设备名，在软件内唯一
    "name": "Pos", // 消息类型
    "uid": "ea221ffdb4fbea42",  //设备UID
    
}

2. Tag定位数据API配置入口

打开IPS Tool软件，按下图操作进入配置页面

3. MQTT获取Tag定位数据

address: {ip或域名}:{端口}

clientId: 客户端标识，可为空

topic: 主题名

4. UDP获取Tag定位数据

address: {ip或域名}:{端口}

5. webhook获取Tag定位数据

url格式: http://{ip或域名}:{端口}/{自定义uri}

http method: POST

6. HTTP获取设备状态

URL: GET http://localhost:8088/openapi/v1/devices?deviceType=&online=&query=&page=&pageSize=

Query参数：

参数名	参数类型	参数说明
deviceType	int	根据设备类型搜索，空表示查询所有类型设备，4表示查询Anchor设备，5表示查询Tag设备
online	bool	根据是否在线搜索，空表示查询所有状态，false表示查询离线设备，true表示查询在线设备
query	string	根据设备名前缀搜索或者设备UID后缀搜索
page	int	分页页码，默认为1，1表示第一页，依次类推
pageSize	int	分页每页大小，默认为20，最大100

响应数据：

{
    "code": 0, // 0表示成功，非0表示失败
    "message": "",
    "data": {
        "records": [
          {
            "type": 4,  // 设备类型，4表示Anchor设备，5表示Tag设备
            "online": false, // 是否在线
            "onlineTime": 1727323909, //在线离线时间，online为true表示在线时间，online为false表示离线时间
            "uid": "1b00530007503148", // 设备UID
            "product": "A01", // 设备型号
            "coordinate": { // 设备坐标，目前仅Anchor设备有
                "coords": [
                  13.302,  // x坐标
                  12.9,    // y坐标
                  2.9      // z坐标
                ]
             },
             "name": "A1" // 设备名 
           },
           {
             "type": 5, // 设备类型，4表示Anchor设备，5表示Tag设备
             "online": false, // 是否在线
             "onlineTime": 1730860539, //在线离线时间，online为true表示在线时间，online为false表示离线时间
             "uid": "72bc78a7911d836f", // 设备UID
             "power": 50,  // 设备电量百分比，目前仅Tag设备有
             "product": "T02", // 设备型号
             "name": "T5" // 设备名 
           }
    	],
    	"total": 1 // 当前搜索条件下的总数
    }
}