# 查询设备激活详情

调试工具

接口应在服务器端调用，详细说明参见服务端API。

设备音视频通话能力调整，不再需要调用本接口。详见小程序音视频通话（for 硬件）激励政策公告

# 接口说明

# 接口英文名

getLicenseDeviceInfo

# 功能描述

该接口用于批量查询设备剩余有效期。

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/wxa/business/license/getdeviceinfo?access_token=ACCESS_TOKEN

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：118
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性

类型

必填

说明

access_token

string

是

接口调用凭证，该参数为 URL 参数，非 Body 参数。使用getAccessToken 或者 authorizer_access_token

device_list

array<object>

是

设备列表 (最大100)

	属性	类型	必填	说明
	model_id	string	是	设备型号 id。通过微信公众平台注册设备获得。
	sn	string	是	设备唯一序列号。由厂商分配。

# 返回参数

属性

类型

说明

errcode

number

错误码

errmsg

string

错误信息

device_list

array<object>

设备列表

属性	类型	说明
model_id	string	设备型号唯一标识
sn	string	设备的唯一标识
expire_time	number	设备的过期时间

# 其他说明

自2024年9月9日15时起，为确保兼容性，本接口对于请求设备列表均返回无实际意义的「已激活」，形如：

{
      "model_id": "MODEL_ID2",
      "sn": "SN2",
      "expire_time": 1893427200
}

其中expire_time固定返回2030-01-01 00:00:00时间戳

本接口将于2024年12月31日正式回收，请开发者及时进行调整适配。

详见调整公告

# 调用示例

示例说明: HTTPS请求示例

# 请求数据示例


{
  "device_list": [
    {
      "model_id": "MODEL_ID1",
      "sn": "SN1"
    },
    {
      "model_id": "MODEL_ID2",
      "sn": "SN2"
    }
  ]
}

# 返回数据示例


{
  "errcode": 0,
  "errmsg": "ok",
  "device_list": [
    {
      "model_id": "MODEL_ID1",
      "sn": "SN1",
      "expire_time": 1630425600
    },
    {
      "model_id": "MODEL_ID2",
      "sn": "SN2",
      "expire_time": 1630425600
    }
  ]
}

# 错误码

错误码	错误描述	解决方案
0	ok	ok