查询设备信息 - 探鸽开放平台API文档

请求参数

Header 参数

X-Tg-App-Id

string

必需

开发者帐号的APPID

默认值:

Accept-Language

string

必需

请求端的本地语言（zh-cn, zh-tw, en-us, ja, ko, vi, es, pt, ru, tr, de, it, fr, pl, th, ar）

默认值:

Authorization

string

必需

服务端接口时传入签名计算后的字符串。客户端APP传入用户登陆态数据access_token。两者不要混用。

默认值:

X-Tg-Signed-Headers

string

必需

参与计算签名的header字段。POST等请求传入content-length;content-type;x-tg-app-id;x-tg-date，GET请求传入x-tg-app-id;x-tg-date

默认值:

x-tg-app-id;x-tg-date

示例值:

content-length;content-type;x-tg-app-id;x-tg-date

X-Tg-Date

string

必需

当前请求的UTC+0时间（注意时区，不是本地时区）

默认值:

20060102T150405Z

Body 参数application/json

device_id

string

必需

fields

array[string]

动态字段

可选

通过传入字段来获取对应的数据

枚举值:

product

示例

{
  "device_id": "1702D8OCDC82",
  "fields": [
    "product"
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

data

object

必需

device_type

string

设备类型

必需

attrs_object

object

必需

attrs

string

属性

必需

actived

string

激活状态

必需

2:激活，其他未激活

active_time

string

激活时间

必需

2024-03-29 09:56:55

firmware_id

string

固件类型

必需

current_version

string

当前版本

必需

sdk_lib_version

integer

必需

timezone

string

时区

必需

ai_abilities

string

ai能力集

必需

abilities

string

设备能力集

必需

设备上报的能力集

ext_attrs

string

开发者扩展属性

必需

扩展属性

iccid

string

4G卡号

必需

imei

string

必需

uuid

string

设备ID

必需

msg

string

必需

integer

必需

requestid

string

必需

status

string

必需

示例

{
  "code": 200,
  "data": {
    "abilities": "{\"EventSet\":[[\"motion\",\"body\",\"sound\",\"doorbell\"],[]],\"Microphone\":\"TuneVol\",\"MultiChannels\":\"3-composed\",\"RecordConf\":\"Yes,res\",\"RotateVideo\":\"Yes\"}",
    "active_time": "2024-03-29 09:56:55",
    "actived": "2",
    "ai_abilities": "{\"hw_ai\":[{\"flags\":3,\"type\":\"bd\"}],\"sw_ai\":[\"mt\"]}",
    "attrs": "{\"category\":\"ipc\",\"network\":\"sim\",\"os\":\"linux\",\"protocol\":\"ppcs\"}",
    "attrs_object": {
      "category": "ipc",
      "network": "sim",
      "os": "linux",
      "wakeup": "",
      "power": "",
      "protocol": "ppcs"
    },
    "connect_way": "sim",
    "current_version": "49000001",
    "device_type": "sim",
    "ext_attrs": "{\"model\":\"cloudCam\"}",
    "firmware_id": "aj_ipc_pip_001",
    "iccid": "89860324402001856921",
    "imei": "865324076579265",
    "sdk_lib_version": 171,
    "timezone": "GMT+08:00,Asia/Shanghai",
    "uuid": "6333FTKP6DGF"
  },
  "msg": "ok",
  "ok": 1,
  "requestid": "c0b4c473-8505-468f-9cea-7fa5f7ec49de",
  "status": "ok"
}

🟠400错误

🟠401请登录

🟠403禁止访问

🟠404资源不存在

🔴500服务器内部错误