申请设备ID

接口说明 

申请配置设备所需的UUID、Major、Minor。申请成功后返回批次ID,可用返回的批次ID通过“查询设备ID申请状态”接口查询目前申请的审核状态。

若单次申请的设备ID数量小于500个,系统会进行快速审核;若单次申请的设备ID数量大于等 500个 ,会在三个工作日内完成审核。

如果已审核通过,可用返回的批次ID通过“查询设备列表”接口拉取本次申请的设备ID。 通过接口申请的设备ID,需先配置页面,若未配置页面,则摇不出页面信息。

一个公众账号最多可申请100000个设备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数据格式:json
POST数据例子:
{
   "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。