
接口说明
申请配置设备所需的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。 |
接口说明
查询设备ID申请的审核状态。若单次申请的设备ID数量小于等于500个,系统会进行快速审核;若单次申请的设备ID数量大于500个,则在三个工作日内完成审核。
接口调用说明
http请求方式: POST(请使用https协议)https://api.weixin.qq.com/shakearound/device/applystatus?access_token=ACCESS_TOKENPOST数据格式:json
POST数据例子:
{
"apply_id": 12345
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| access_token | 是 | 调用接口凭证 |
| apply_id | 是 | 批次ID,申请设备ID时所返回的批次ID |
返回说明
正常时的返回JSON数据包示例:
{
"data": {
"apply_time": 1432026025,
"audit_comment": "test",
"audit_status": 1,
"audit_time": 0
},
"errcode": 0,
"errmsg": "success."
}相关
视频
RELATED VIDEOS
科技资讯
1
2
3
4
5
6
7
8
9
精选课程
共5课时
17.2万人学习
共49课时
77万人学习
共29课时
61.7万人学习
共25课时
39.3万人学习
共43课时
70.9万人学习
共25课时
61.6万人学习
共22课时
23万人学习
共28课时
33.9万人学习
共89课时
125万人学习