# 激活设备license

调试工具

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

# 接口说明

# 接口英文名

activeLicenseDevice

# 功能描述

该接口用于批量绑定设备,并消耗相应的资源包中的激活码序号。

# 注意事项

  • 正式license的使用:每次调用最多激活100个设备,且所有设备类型必须属于同一个资源包类型。每个激活码序号只能用于激活一台设备。每个设备最多绑定 3 个激活码序号,即剩余有效时间不能超过 3 年。
  • 体验license的使用:详见平台公告

# 调用方式

# HTTPS 调用


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

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:118

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性 类型 必填说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken 或者 authorizer_access_token
device_list array<object> 待激活的设备列表
属性 类型 必填 说明
model_id string 设备型号 id。通过微信公众平台注册设备获得。
sn string 设备唯一序列号。由厂商分配。
active_number number 激活码序号,任意 uint32 整数(需与之前使用过的不重复)。主要用于防止重复请求导致重复激活。
pkg_type number 资源包类型,0:测试体验包(默认),1:A 类设备,2:B 类设备,3:C 类设备,4:D 类设备,5:E类设备

# 返回参数

属性 类型说明
errcode number 错误码
errmsg string 错误信息
device_list array<object> 设备列表
属性 类型 说明
model_id string 设备型号唯一标识
sn string 设备的唯一标识
expire_time number 设备的过期时间
errcode number 错误码

# 其他说明

激活码序号仅用于防重放(防止相同请求重复发起导致同一台设备误绑多个license),并不具有其他实际意义。开发者可以维护序号作为设备 license 的标识,也可以使用不会重复的ID、时间戳或随机数等。

# 调用示例

示例说明: HTTPS请求示例

# 请求数据示例


{
  "pkg_type": 0,
  "device_list": [
    {
      "model_id": "MODEL_ID1",
      "sn": "SN1",
      "active_number": 1
    },
    {
      "model_id": "MODEL_ID2",
      "sn": "SN2",
      "active_number": 2
    }
  ]
} 

# 返回数据示例


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

# 错误码

错误码 错误描述 解决方案
0 ok ok
9800020 设备数超出限制 检查设备数量
9800040 资源包类型和设备类型不匹配 检查设备类型
9800039 资源包余额不足 检查资源包余额
9800020 设备数超出限制 检查设备数量
9800037 激活码序号已使用 更换激活码序号
9800038 设备有效期超出限制 检查设备有效期