W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
接口說明
申請配置設(shè)備所需的UUID、Major、Minor。申請成功后返回批次ID,可用返回的批次ID通過“查詢設(shè)備ID申請狀態(tài)”接口查詢目前申請的審核狀態(tài)。
若單次申請的設(shè)備ID數(shù)量小于500個,系統(tǒng)會進行快速審核;若單次申請的設(shè)備ID數(shù)量大于等 500個 ,會在三個工作日內(nèi)完成審核。
如果已審核通過,可用返回的批次ID通過“查詢設(shè)備列表”接口拉取本次申請的設(shè)備ID。 通過接口申請的設(shè)備ID,需先配置頁面,若未配置頁面,則搖不出頁面信息。
一個公眾賬號最多可申請100000個設(shè)備ID,如需申請的設(shè)備ID數(shù)超過最大限額,請郵件至zhoubian@tencent.com,郵件格式如下:
標題:申請?zhí)嵘O(shè)備ID額度
內(nèi)容:
1、公眾賬號名稱及appid(wx開頭的字符串,在mp平臺可查看)
2、用途
3、預估需要多少設(shè)備ID
接口調(diào)用說明
http請求方式: POST(請使用https協(xié)議)https://api.weixin.qq.com/shakearound/device/applyid?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式:json
POST數(shù)據(jù)例子:
{
"quantity":3,
"apply_reason":"測試",
"comment":"測試專用",
"poi_id":1234
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
quantity | 是 | 申請的設(shè)備ID的數(shù)量,單次新增設(shè)備超過500個,需走人工審核流程 |
apply_reason | 是 | 申請理由,不超過100個漢字或200個英文字母 |
comment | 否 | 備注,不超過15個漢字或30個英文字母 |
poi_id | 否 | 設(shè)備關(guān)聯(lián)的門店ID,關(guān)聯(lián)門店后,在門店1KM的范圍內(nèi)有優(yōu)先搖出信息的機會。門店相關(guān)信息具體可查看門店相關(guān)的接口文檔 |
返回說明
正常時的返回JSON數(shù)據(jù)包示例:
{
"data": {
"apply_id": 123,
"audit_status": 1,
"audit_comment": "審核中"
},
"errcode": 0,
"errmsg": "success."
}
參數(shù)說明
參數(shù) | 說明 |
---|---|
audit_status | 審核狀態(tài)。0:審核未通過、1:審核中、2:審核已通過;若單次申請的設(shè)備ID數(shù)量小于等于500個,系統(tǒng)會進行快速審核;若單次申請的設(shè)備ID數(shù)量大于500個,會在三個工作日內(nèi)完成審核;此時返回值全部為1(審核中) |
audit_comment | 審核備注,對審核狀態(tài)的文字說明 |
apply_id | 申請的批次ID,可用在“查詢設(shè)備列表”接口按批次查詢本次申請成功的設(shè)備ID。 |
接口說明
查詢設(shè)備ID申請的審核狀態(tài)。若單次申請的設(shè)備ID數(shù)量小于等于500個,系統(tǒng)會進行快速審核;若單次申請的設(shè)備ID數(shù)量大于500個,則在三個工作日內(nèi)完成審核。
接口調(diào)用說明
http請求方式: POST(請使用https協(xié)議)https://api.weixin.qq.com/shakearound/device/applystatus?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式:json
POST數(shù)據(jù)例子:
{
"apply_id": 12345
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
apply_id | 是 | 批次ID,申請設(shè)備ID時所返回的批次ID |
返回說明
正常時的返回JSON數(shù)據(jù)包示例:
{
"data": {
"apply_time": 1432026025,
"audit_comment": "test",
"audit_status": 1,
"audit_time": 0
},
"errcode": 0,
"errmsg": "success."
}
參數(shù)說明
參數(shù) | 說明 |
---|---|
apply_time | 提交申請的時間戳 |
audit_status | 審核狀態(tài)。0:審核未通過、1:審核中、2:審核已通過;若單次申請的設(shè)備ID數(shù)量小于等于500個,系統(tǒng)會進行快速審核;若單次申請的設(shè)備ID數(shù)量大于500個,會在三個工作日內(nèi)完成審核; |
audit_comment | 審核備注,對審核狀態(tài)的文字說明 |
audit_time | 確定審核結(jié)果的時間戳,若狀態(tài)為審核中,則該時間值為0 |
接口說明
編輯設(shè)備的備注信息。可用設(shè)備ID或完整的UUID、Major、Minor指定設(shè)備,二者選其一。
接口調(diào)用說明
http請求方式: POST(請使用https協(xié)議)https://api.weixin.qq.com/shakearound/device/update?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式:json
POST數(shù)據(jù)例子:
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"comment": “test”
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
device_identifier | 是 | 指定的設(shè)備ID |
device_id | 是 | 設(shè)備編號,若填了UUID、major、minor,則可不填設(shè)備編號,若二者都填,則以設(shè)備編號為優(yōu)先 |
UUID、major、minor | 是 | UUID、major、minor,三個信息需填寫完整,若填了設(shè)備編號,則可不填此信息。 |
comment | 是 | 設(shè)備的備注信息,不超過15個漢字或30個英文字母。 |
返回說明
正常時的返回JSON數(shù)據(jù)包示例:
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}
接口說明
支持創(chuàng)建門店后直接關(guān)聯(lián)在設(shè)備上,無需為審核通過狀態(tài),搖周邊后臺自動更新門店的最新信息和狀態(tài)。
接口調(diào)用說明
http請求方式: POST(請使用https協(xié)議)https://api.weixin.qq.com/shakearound/device/bindlocation?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式:json
POST數(shù)據(jù)例子:
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"poi_id": 1231,
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
device_identifier | 是 | 指定的設(shè)備ID |
device_id | 是 | 設(shè)備編號,若填了UUID、major、minor,則可不填設(shè)備編號,若二者都填,則以設(shè)備編號為優(yōu)先 |
UUID、major、minor | 是 | UUID、major、minor,三個信息需填寫完整,若填了設(shè)備編號,則可不填此信息。 |
poi_id | 是 | 設(shè)備關(guān)聯(lián)的門店ID,關(guān)聯(lián)門店后,在門店1KM的范圍內(nèi)有優(yōu)先搖出信息的機會。當值為0時,將清除設(shè)備已關(guān)聯(lián)的門店ID。門店相關(guān)信息具體可查看門店相關(guān)的接口文檔 |
返回說明
正常時的返回JSON數(shù)據(jù)包示例:
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}
接口說明
支持設(shè)備關(guān)聯(lián)其他公眾賬號的門店,門店需為審核通過狀態(tài)。
因為第三方門店不歸屬本公眾賬號,所以未保存到設(shè)備詳情中,查詢設(shè)備列表接口與獲取搖周邊的設(shè)備及用戶信息接口不會返回第三方門店。如需驗證請使用搖一搖關(guān)注JS API驗證。
若設(shè)備上綁定自己門店,則自動屏蔽第三方門店相關(guān)功能。
接口調(diào)用說明
http請求方式: POST(請使用https協(xié)議)https://api.weixin.qq.com/shakearound/device/bindlocation?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式:json
POST數(shù)據(jù)例子:
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"poi_id": 1231,
"type": 2,
"poi_appid": "wxappid"
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
device_identifier | 是 | 指定的設(shè)備ID |
device_id | 是 | 設(shè)備編號,若填了UUID、major、minor,則可不填設(shè)備編號,若二者都填,則以設(shè)備編號為優(yōu)先 |
UUID、major、minor | 是 | UUID、major、minor,三個信息需填寫完整,若填了設(shè)備編號,則可不填此信息。 |
poi_id | 是 | 設(shè)備關(guān)聯(lián)的門店ID,關(guān)聯(lián)門店后,在門店1KM的范圍內(nèi)有優(yōu)先搖出信息的機會。當值為0時,將清除設(shè)備已關(guān)聯(lián)的門店ID。門店相關(guān)信息具體可查看門店相關(guān)的接口文檔 |
Type | 否,不填默認為1 | 為1時,關(guān)聯(lián)的門店和設(shè)備歸屬于同一公眾賬號; 為2時,關(guān)聯(lián)的門店為其他公眾賬號的門店 |
Poi_appid | 當Type為2時,必填 | 關(guān)聯(lián)門店所歸屬的公眾賬號的APPID |
返回說明 正常時的返回JSON數(shù)據(jù)包示例:
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}
接口說明
查詢已有的設(shè)備ID、UUID、Major、Minor、激活狀態(tài)、備注信息、關(guān)聯(lián)門店、關(guān)聯(lián)頁面等信息??芍付ㄔO(shè)備ID或完整的UUID、Major、Minor查詢,也可批量拉取設(shè)備信息列表。查詢所返回的設(shè)備列表按設(shè)備ID正序排序。
接口調(diào)用說明
http請求方式: POST(請使用https協(xié)議)https://api.weixin.qq.com/shakearound/device/search?access_token=ACCESS_TOKENPOST數(shù)據(jù)格式:json
POST數(shù)據(jù)例子:
查詢指定設(shè)備時:
{
"type": 1,
"device_identifiers":[
{
"device_id":10100,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":10001,
"minor":10002
}
]
}
需要分頁查詢或者指定范圍內(nèi)的設(shè)備時:
{
"type": 2,
"last_seen": 10097,
"count": 3
}
當需要根據(jù)批次ID查詢時:
{
"type": 3,
"apply_id": 1231,
"last_seen": 10097,
"count": 3
}
參數(shù)說明
參數(shù) | 是否必須 | 說明 |
---|---|---|
access_token | 是 | 調(diào)用接口憑證 |
type | 是 | 查詢類型。1:查詢設(shè)備id列表中的設(shè)備;2:分頁查詢所有設(shè)備信息;3:分頁查詢某次申請的所有設(shè)備信息 |
device_identifiers | 是 | 指定的設(shè)備 ; 當type為1時,此項為必填 |
device_id | 是 | 設(shè)備編號,若填了UUID、major、minor,則可不填設(shè)備編號,若二者都填,則以設(shè)備編號為優(yōu)先;查詢指定設(shè)備時,單次查詢的設(shè)備數(shù)量不能超過50個 |
UUID、major、minor | 是 | UUID、major、minor,三個信息需填寫完整,若填了設(shè)備編號,則可不填此信息;查詢指定設(shè)備時,單次查詢的設(shè)備數(shù)量不能超過50個 |
apply_id | 是 | 批次ID,申請設(shè)備ID時所返回的批次ID;當type為3時,此項為必填 |
last_seen | 是 | 前一次查詢列表末尾的設(shè)備ID , 第一次查詢last_seen 為0 |
count | 是 | 待查詢的設(shè)備數(shù)量,不能超過50個 |
返回說明
正常時的返回JSON數(shù)據(jù)包示例:
{
"data": {
"devices": [
{
"comment": "",
"device_id": 10097,
"major": 10001,
"minor": 12102,
"status": 1,
"last_active_time":1437276018,
"poi_id": 0,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
},
{
"comment": "",
"device_id": 10098,
"major": 10001,
"minor": 12103,
"status": 1,
"last_active_time":1437276018,
"poi_appid":"wxe3813f5d8c546fc7"
"poi_id": 123,
"uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
}
],
"total_count": 151
},
"errcode": 0,
"errmsg": "success."
}
參數(shù)說明
參數(shù) | 說明 |
---|---|
devices | 指定的設(shè)備信息列表 |
device_id | 設(shè)備編號 |
UUID、major、minor | UUID、major、minor |
status | 激活狀態(tài),0:未激活,1:已激活 |
last_active_time | 設(shè)備最近一次被搖到的日期(最早只能獲取前一天的數(shù)據(jù));新申請的設(shè)備該字段值為0 |
poi_appid | 若配置了設(shè)備與其他公眾賬號門店關(guān)聯(lián)關(guān)系,則返回配置門店歸屬的公眾賬號appid。查看配置設(shè)備與其他公眾賬號門店關(guān)聯(lián)關(guān)系接口 |
poi_id | 設(shè)備關(guān)聯(lián)的門店ID,關(guān)聯(lián)門店后,在門店1KM的范圍內(nèi)有優(yōu)先搖出信息的機會。門店相關(guān)信息具體可查看門店相關(guān)的接口文檔 |
comment | 設(shè)備的備注信息 |
total_count | 商戶名下的設(shè)備總量 |
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: