開(kāi)通微信連Wi-Fi插件
開(kāi)通微信連Wi-Fi插件
開(kāi)通微信連Wi-Fi插件
調(diào)用微信連Wi-Fi其他所有接口的前提是已開(kāi)通“微信連Wi-Fi”功能插件，目前開(kāi)通插件共有兩種方法：1）在微信公眾平臺(tái)通過(guò)頁(yè)面操作添加“微信連Wi-Fi“功能插件；2）調(diào)用此接口開(kāi)通插件。
注：開(kāi)通插件接口只支持公眾號(hào)第三方平臺(tái)調(diào)用，公眾賬號(hào)開(kāi)發(fā)者請(qǐng)?jiān)?a class="external text" rel="nofollow" target="_blank" style="outline: red dotted 0.2em !important; color: rgb(54, 103, 153); text-decoration: none; outline-offset: 0.2em;">微信公眾平臺(tái)自行開(kāi)通。第三方平臺(tái)接入，請(qǐng)參考微信開(kāi)放平臺(tái)。
開(kāi)通插件流程
流程詳細(xì)說(shuō)明
1. 用戶進(jìn)入第三方平臺(tái)網(wǎng)站并授權(quán)登錄
用戶需要先進(jìn)入第三方平臺(tái)網(wǎng)站，如www.ABC.com。第三方平臺(tái)引導(dǎo)用戶進(jìn)行微信公眾號(hào)授權(quán)登錄操作。
2. 第三方平臺(tái)獲取開(kāi)插件wifi_token
協(xié)議：https http請(qǐng)求方式: GET 請(qǐng)求URL：https://api.weixin.qq.com/bizwifi/openplugin/token?access_token=ACCESS_TOKEN POST數(shù)據(jù)格式：JSON
請(qǐng)求參數(shù)說(shuō)明
| 參數(shù) | 是否必須 | 說(shuō)明 |
|---|---|---|
| access_token | 是 | 調(diào)用接口憑證 |
| POST數(shù)據(jù) | 是 | JSON數(shù)據(jù) |
POST數(shù)據(jù)
數(shù)據(jù)示例：
{
"callback_url": "http://weixin.qq.com/"
}字段說(shuō)明：
| 字段 | 是否必填 | 說(shuō)明 |
|---|---|---|
| callback_url | 是 | 回調(diào)URL，開(kāi)通插件成功后的跳轉(zhuǎn)頁(yè)面。注：該參數(shù)域名必須與跳轉(zhuǎn)進(jìn)開(kāi)通插件頁(yè)面的頁(yè)面域名保持一致，建議均采用第三方平臺(tái)域名。 |
返回?cái)?shù)據(jù)說(shuō)明 正確返回JSON數(shù)據(jù)示例：
{
"errcode": 0,
"data": {
"is_open": true,
"wifi_token": ""
}
}字段說(shuō)明：
| 字段 | 說(shuō)明 |
|---|---|
| is_open | 該公眾號(hào)是否已開(kāi)通微信連Wi-Fi插件，true-已開(kāi)通，false-未開(kāi)通 |
| wifi_token | 開(kāi)通插件的憑證，當(dāng)is_open為false時(shí)才返回值 |
3. 引導(dǎo)用戶進(jìn)入開(kāi)通插件頁(yè)面
第三方平臺(tái)可以在自己的網(wǎng)頁(yè)中放置“開(kāi)通微信連Wi-Fi插件”的入口，引導(dǎo)用戶進(jìn)入開(kāi)通插件頁(yè)面。建議第三方平臺(tái)采用“在當(dāng)前頁(yè)面打開(kāi)“的形式打開(kāi)開(kāi)通插件頁(yè)面。
網(wǎng)址為：https://wifi.weixin.qq.com/biz/mp/thirdProviderPlugin.xhtml?token=xxxx ，該網(wǎng)址中第三方平臺(tái)需提供已獲取的wifi_token。
4. 用戶填寫(xiě)信息，開(kāi)通插件
用戶在開(kāi)通插件頁(yè)面填寫(xiě)相關(guān)信息，完成開(kāi)通插件操作。
5. 跳轉(zhuǎn)callback_url
用戶開(kāi)通插件成功后，網(wǎng)頁(yè)將自動(dòng)跳轉(zhuǎn)到第三方平臺(tái)調(diào)用“獲取開(kāi)通插件wifi_token”接口時(shí)提供的callback_url中，完成開(kāi)通插件流程。之后第三方平臺(tái)可以調(diào)用其他接口為用戶提供微信連Wi-Fi服務(wù)。