查询设备详情

查询特定设备的详细信息。

请求URL

GET {base_url}/device/openapi/v1.0/devices/{deviceId}

请求参数

表 1. 头部参数
参数 是否必填 类型 描述
Authorization 是 String API调用的有效访问token。

格式为 Bearer {access_token}。
表 2. 路径参数
参数 是否必填 类型 描述
deviceId 是 Integer 设备的唯一标识符，当您添加设备时会返回。
注： 如果您没有保存设备ID，可以使用以下方法查询设备的ID 查询设备列表。

响应参数

参数 类型 描述
data 对象<Device_Info>Object<Device_Info> 查询设备的详细信息。
status String API的请求结果。
  • Success
  • Failed
requestId String 唯一的请求ID ,可用于快速定位请求。
设备信息
参数 类型 描述
sn String 设备的序列号（SN）。
imei String 设备的IMEI（国际移动身份验证码）。
autopStatus String 设备的自动配置状态。
  • SUCCESS: 设备已成功进行了自动配置。
  • WAITING: 设备正在等待进行自动配置。
  • DISABLE: 设备自动配置已禁用。
name String 设备名称。
model String 设备型号。
hardwareVersion String 设备硬件版本。
firmwareVersion String 设备固件版本。
electricity Integer 设备电池电量水平。
lastUpdateTime Integer 设备最近一次报告的时间戳。
application Object 与设备关联的应用信息。
applicationId Integer 应用信息的唯一标识符。
applicationName String 应用信息的名称。
project String 设备标签。
description String 设备描述。
deviceId Integer 设备的唯一标识符。
devEUI String 设备的EUI（扩展唯一标识符）。
connectStatus String 设备的连接状态。
  • ONLINE: 设备已经成功连接到星纵物联开放平台。
  • OFFLINE: 设备目前未连接到星纵物联开放平台。
  • DISCONNECT: 设备已从星纵物联开放平台断开。

示例

请求示例
查询ID为"1739930666380779522"的设备的详细信息。
GET /device/openapi/v1.0/devices/1739930666380779522 HTTP/1.1
Host: milesight.demo.com
Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6InllYXN0b25lLWRlZmF1bHQta2V5LWlkIn0.eyJncmFudF90eXBlIjoiY2xpZW50X2NyZWRlbnRpYWxzIiwic2NvcGUiOlsib3BlbmFwaSJdLCJjbGllbnRfZXh0Ijp7ImFwcF9pZCI6IjE3MzY5NTQ4MDE3MTMzMjgxMzAifSwiZXhwIjoxNzAzMjEzMDk4LCJhdXRob3JpdGllcyI6WyJST0xFX0NMSUVOVCJdLCJqdGkiOiJiYjJjN2U4Yy03NGQwLTQ4NjEtODE3MS1iYTc0NWRlMGY0NmQiLCJjbGllbnRfaWQiOiI4OTNkNzdjNy1mMGNiLTRmMzQtOWNhMS03YzJhNGNmMTEzNDgiLCJ0cyI6MTcwMzIwOTQ5ODMzNH0
Content-Type: application/json
User-Agent: OpenAPI
响应示例 
HTTP/1.1 200 OK
{
    "data": {
        "sn": "6791D1970467xxxx",
        "autopStatus": "DISABLE",
        "name": "Demo Device",
        "model": "WS203",
        "hardwareVersion": "v1.0",
        "firmwareVersion": "v1.1",
        "electricity": 97,
        "lastUpdateTime": 1704172785337,
        "application": {
            "applicationId": "1734475086466600962",
            "applicationName": "Demo"
        },
        "project": "Demo",
        "description": "Demo",
        "deviceId": "1739930666380779522",
        "devEUI": "24E124791D1xxxx",
        "connectStatus": "ONLINE"
    },
    "status": "Success",
    "requestId": "c15d037ea4c74565ecced1725c8d46d6"
}