微信設(shè)備ID

2019-03-14 12:03 更新

申請設(shè)備ID

微信

接口說明 

申請配置設(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申請的審核狀態(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è)備的備注信息。可用設(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、minorUUID、major、minor,三個信息需填寫完整,若填了設(shè)備編號,則可不填此信息。
comment設(shè)備的備注信息,不超過15個漢字或30個英文字母。

返回說明 

正常時的返回JSON數(shù)據(jù)包示例:

{
    "data": {    
    },
    "errcode": 0,
    "errmsg": "success."
}

配置設(shè)備與門店的關(guān)聯(lián)關(guān)系

接口說明

支持創(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、minorUUID、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)關(guān)系

 接口說明

支持設(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、minorUUID、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è)備列表

接口說明 

查詢已有的設(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、minorUUID、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、minorUUID、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è)備總量





以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號