開發文件規範
阿新 • • 發佈：2020-09-11
範例
申請開通功能 (介面名稱)
介面說明
申請開通搖一搖周邊功能。成功提交申請請求後，工作人員會在三個工作日內完成稽核。若稽核不通過，可以重新提交申請請求。若是稽核中，請耐心等待工作人員稽核，在稽核中狀態不能再提交申請請求。
介面呼叫說明
http請求方式: POST（請使用https協議）https://api.weixin.qq.com/shakearound/account/register?access_token=ACCESS_TOKENPOST資料格式：json
POST資料例子：
{
"name": "zhang_san",
"phone_number": "13512345678",
"email": "[email protected]",
"industry_id": "0118",
"qualification_cert_urls": [
"http://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0",
"http://shp.qpic.cn/wx_shake_bus/0/1428565236d03d864b7f43db9ce34df5f720509d0e/0"
],
"apply_reason": "test"
}
引數說明
提交引數說明
返回引數說明
| 引數 | 是否必須 | 資料型別 | 說明 |
|---|---|---|---|
| access_token | 是 | string | 呼叫介面憑證 |
| name | 是 | string | 聯絡人姓名，不超過20漢字或40個英文字母 |
| phone_number | 是 | string | 聯絡人電話 |
| 是 | string | 聯絡人郵箱 | |
| industry_id | 是 | string | 平臺定義的行業代號，具體請檢視連結行業代號 |
| qualification_cert_urls | 是 | array | 相關資質檔案的圖片url，圖片需先上傳至微信側伺服器，用“素材管理-上傳圖片素材”介面上傳圖片，返回的圖片URL再配置在此處；
當不需要資質檔案時，陣列內可以不填寫url |
| apply_reason | 否 | string | 申請理由，不超過250漢字或500個英文字母 |
返回說明
正常時的返回JSON資料包示例：
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}
查詢稽核狀態
介面說明查詢已經提交的開通搖一搖周邊功能申請的稽核狀態。在申請提交後，工作人員會在三個工作日內完成稽核。
介面呼叫說明
http請求方式:（請使用https協議）https://api.weixin.qq.com/shakearound/account/auditstatus?access_token=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：稽核已通過；稽核會在三個工作日內完成 |
| audit_comment | 稽核備註，包括稽核不通過的原因 |
| audit_time | 確定稽核結果的時間戳；若狀態為稽核中，則該時間值為0 |