接口说明
申请配置设备所需的UUID、Major、Minor。申请成功后返回批次ID,可用返回的批次ID通过“查询设备ID申请状态”接口查询目前申请的审核状态。
若单次申请的设备ID数量小于500个,系统会进行快速审核;若单次申请的设备ID数量大于等 500个 ,会在三个工作日内完成审核。
如果已审核通过,可用返回的批次ID通过“查询设备列表”接口拉取本次申请的设备ID。 通过接口申请的设备ID,需先配置页面,若未配置页面,则摇不出页面信息。
一个公众账号最多可申请10000个设备ID,如需申请的设备ID数超过最大限额,请邮件至zhoubian@tencent.com,邮件格式如下:
标题:申请提升设备ID额度 内容:1、公众账号名称及appid(wx开头的字符串,在mp平台可查看)2、用途3、预估需要多少设备ID
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/applyid?access_token=ACCESS_TOKENPOST数据格式:jsonPOST数据例子:{ "quantity":3, "apply_reason":"测试", "comment":"测试专用", "poi_id":1234 }
参数说明
参数 | 是否必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
quantity | 是 | 申请的设备ID的数量,单次新增设备超过500个,需走人工审核流程 |
apply_reason | 是 | 申请理由,不超过100个汉字或200个英文字母 |
comment | 否 | 备注,不超过15个汉字或30个英文字母 |
poi_id | 否 | 设备关联的门店ID,关联门店后,在门店1KM的范围内有优先摇出信息的机会。门店相关信息具体可 查看门店相关的接口文档 |
返回说明
正常时的返回JSON数据包示例:
{"data": {
"apply_id": 123,
"audit_status": 1,
"audit_comment": "审核中"
},
"errcode": 0,
"errmsg": "success."
}
参数说明
参数 | 说明 |
---|---|
audit_status | 审核状态。0:审核未通过、1:审核中、2:审核已通过;若单次申请的设备ID数量小于等于500个,系统会进行快速审核;若单次申请的设备ID数量大于500个,会在三个工作日内完成审核;此时返回值全部为1(审核中) |
audit_comment | 审核备注,对审核状态的文字说明 |
apply_id | 申请的批次ID,可用在“查询设备列表”接口按批次查询本次申请成功的设备ID。 |