接口说明

申请配置设备所需的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。