微信設備ID
申請設備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 | |
查詢設備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 | 是 | |
| #呼叫介面憑證 |
返回說明
正常時的回傳JSON封包範例：
{
"data": {
"apply_time": 1432026025,
"audit_comment": "test",
"audit_status": 1,
"audit_time": 0
},
"errcode": 0,
"errmsg": "success."
}
參數說明
| 參數 | 說明 |
|---|---|
| apply_time | 提交申請的時間戳記 |
| #audit_status | 審核狀態。 0：審核未通過、1：審核中、2：審核已通過；若單次申請的設備ID數量小於等於500個，系統會進行快速審核；若單次申請的設備ID數量大於500個，會在三個工作天內完成審核； |
| audit_comment | 審核備註，對審核狀態的文字說明 |
| audit_time | #確定審核結果的時間戳，若狀態為審核中，則該時間值為0 |
編輯裝置資訊
介面說明
編輯裝置的備註資訊。可用設備ID或完整的UUID、Major、Minor指定設備，二者選其一。
介面呼叫說明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/update?access_token=ACCESS_TOKENPOST数据格式：json
POST数据例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"comment": “test”
}參數說明
#| 參數 | 是否必須 | ##說明 |
|---|---|---|
| access_token | 是 | |
| #呼叫介面憑證 | ||
| # ########device_identifier############是############指定的裝置ID############ ######device_id############是### | 裝置編號，若填了UUID、major、minor，則可不填設備編號，若二者都填，則以設備編號為優先 | |
返回說明
正常時的回傳JSON封包範例：
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}設定裝置與門市的關聯關係
#介面說明
支援建立門市後直接關聯在裝置上，無需為審核通過狀態，搖週邊後台自動更新門市的最新資訊和狀態。
介面呼叫說明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/bindlocation?access_token=ACCESS_TOKENPOST数据格式：json
POST数据例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"poi_id": 1231,
}參數說明
#| 參數 | 是否必須 | ##說明 |
|---|---|---|
| access_token | 是 | |
| #呼叫介面憑證 | ||
| # ########device_identifier############是############指定的裝置ID############ ######device_id############是### | 裝置編號，若填了UUID、major、minor，則可不填設備編號，若二者都填，則以設備編號為優先 | |
返回說明
正常時的回傳JSON封包範例：
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}配置裝置與其他公用帳號門市的關聯關係
介面說明
#支援裝置關聯其他公用帳號的門市，門市需為審核通過狀態。
因為第三方門市不歸屬本公眾帳號，所以未儲存到裝置詳情中，查詢裝置清單介面與取得搖週邊的裝置及使用者資訊介面不會回傳第三方門市。如需驗證請使用搖一搖關注JS API驗證。
若裝置上綁定自己門市，則自動封鎖第三方門市相關功能。
介面呼叫說明
http请求方式: POST（请使用https协议）https://api.weixin.qq.com/shakearound/device/bindlocation?access_token=ACCESS_TOKENPOST数据格式：json
POST数据例子：
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"poi_id": 1231,
"type": 2,
"poi_appid": "wxappid"
}參數說明
############################################## #| 參數 | 是否必須 | ##說明 |
|---|---|---|
| access_token | 是 | |
| #呼叫介面憑證 | ||
| # ########device_identifier############是############指定的裝置ID############ ######device_id############是### | 裝置編號，若填了UUID、major、minor，則可不填設備編號，若二者都填，則以設備編號為優先 | |
| ##UUID、major、minor | 是 | UUID、major、minor，三個資訊需填寫完整，若填了設備編號，可不填此資訊。 ######poi_id#############是############裝置關聯的門市ID，關聯門市後，在門市1KM的範圍內有優先搖出資訊的機會。當值為0時，將清除設備已關聯的門市ID。門市相關資訊可具體可######檢視門市相關的介面文件##################Type###########否，不填預設為1###############為1時，關聯的門市和設備歸屬於同一公眾帳號；#######為2時，關聯的門市為其他公眾帳號的門市 |
| #Poi_appid | ##當Type為2時，必填 | 關聯門市所歸屬的公用帳號的APPID |
| 參數 | 是否必須 | ##說明 |
|---|---|---|
| access_token | 是 | |
| #呼叫介面憑證 | ################################## ########type############是#############查詢類型。1：查詢設備id清單中的設備；2：分頁查詢所有設備資訊；3：分頁查詢某次申請的所有設備資訊 | |
| device_identifiers | 是 | 指定的裝置； 當type為1時，此項目為必填 |
| ##device_id | 是 | #裝置編號，若填了UUID、major、minor，則可不填裝置編號，若二者都填，則以設備編號為優先；查詢指定設備時，單次查詢的設備數量不能超過50個 |
| UUID、major、 minor | 是 | UUID、major、minor，三個資訊需填寫完整，若填了設備編號，則可不填此資訊；當查詢指定裝置時，單次查詢的裝置數量不能超過50個 |
| #apply_id | ##是 | 批次ID，申請裝置ID時所傳回的批次ID；當type為3時，此項目為必填 |
| last_seen | 是### | 前一次查詢清單末端的裝置ID ， 第一次查詢last_seen 為0 |
| count | 是 | 待查詢的裝置數量，不能超過50個 |
| 參數 | 說明 |
|---|---|
| #devices | 指定的裝置資訊清單 |
| #device_id | 裝置編號 |
| UUID、major、minor | #UUID、major、minor |
| ##status | |
| 啟動狀態，0：未激活，1：已啟動 | ##last_active_time #########裝置最近一次被搖到的日期（最早只能取得前一天的資料）；新申請的裝置該欄位值為0### |
| poi_appid | #若設定了裝置與其他公用帳號門市關聯關係，則傳回配置門市歸屬的公用帳號appid。 檢視設定裝置與其他公用帳號門市關聯關係介面 |
| poi_id | #裝置關聯的門市ID，關聯門市後，在門市1KM的範圍內有優先搖出資訊的機會。門市相關資訊具體可 |
| 查看門市相關的介面文件 | comment |
total_count商家名稱下的裝置總量
###### ########################################################### ####
