搖一搖周邊是微信提供的一項近場互動能力,讓用戶搖動手機就能接收到商家設定的頁面、卡券或活動資訊。要使用這套能力,第一步不是寫程式,而是先把帳號的權限開通。以下整理開通申請與狀態查詢兩個環節的介面用法與注意事項。
提交申請後,微信工作人員通常會在三個工作日內完成審核。若審核未通過,可以修正資料後重新提交;若目前狀態是「審核中」,則無法再次提交,只能等待結果。
申請介面如下:
請求方式:POST(請使用 https)
https://api.weixin.qq.com/shakearound/account/register?access_token=ACCESS_TOKEN
POST 資料範例:
{
"name": "zhang_san",
"phone_number": "13512345678",
"email": "weixin123@qq.com",
"industry_id": "0118",
"qualification_cert_urls": [
"https://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0",
"https://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0"
],
"apply_reason": "test"
}
參數說明:
成功時的回應:
{
"data": {},
"errcode": 0,
"errmsg": "success."
}
提交之後不必一直猜結果,可以直接呼叫查詢介面取得審核進度:
請求方式(請使用 https): https://api.weixin.qq.com/shakearound/account/auditstatus?access_token=ACCESS_TOKEN
回應範例:
{
"data": {
"apply_time": 1432026025,
"audit_comment": "test",
"audit_status": 1,
"audit_time": 0
},
"errcode": 0,
"errmsg": "success."
}
欄位含義:
實作上建議把查詢寫成排程或後台按鈕,而不是靠人工反覆呼叫,這樣一旦狀態變成 2 就能立刻接著做後續的頁面配置與設備綁定。