【2018微信小程序最新API接口與插件大全】
【2018微信小程序最新API接口與插件大全】微信小程序API接口、微信小程序插件、微信小程序插件管理【珠海網站建設電話:400-000-1280】微信小程序開發者可通過以下接口管理插件,包括:添加、刪除、查詢已添加的插件,微信小程序插件開發者也可調用接口管理插件使用申請。
微信小程序API接口與插件大全
插件管理權限集用于第三方代小程序管理插件,具體包括:添加插件、查詢已添加的插件及刪除插件。具體接口列表如下:
1.申請使用插件
2.查詢已添加的插件
3.刪除已添加的插件
1.申請使用插件接口
此接口用于小程序向插件開發者發起使用插件的申請。
請求方式: POST(請使用https協議)
https://api.weixin.qq.com/wxa/plugin?access_token=TOKEN
POST數據示例
{ "action":"apply", "plugin_appid":"aaaa", }
參數說明
參數 | 說明 |
---|---|
action | 填寫apply |
plugin_appid | 插件appid |
返回說明
{ "errcode":0, "errmsg":"ok", }
參數說明
參數 | 說明 |
---|---|
errcode | 錯誤碼 |
errmsg | 錯誤信息 |
錯誤碼說明
錯誤碼 | 說明 |
---|---|
0 | 成功 |
-1 | 系統錯誤 |
89236 | 該插件不能申請 |
89237 | 已經添加該插件 |
89238 | 申請或使用的插件已經達到上限 |
89239 | 該插件不存在 |
2. 查詢已添加的插件
此接口用于查詢小程序目前已添加的插件(包括確認中、已通過、已拒絕、已超時狀態)
請求方式: POST(請使用https協議)
https://api.weixin.qq.com/wxa/plugin?access_token=TOKEN
POST數據示例:
{ "action":"list", }
參數說明
參數 | 說明 |
---|---|
action | 填寫list |
返回說明(正常時返回的json示例)
{ "errcode":0, "errmsg":"ok", "plugin_list":[ "appid":"aaaa", "status":1, "nickname":"插件昵稱", "headimgurl":"http://plugin.qq.com", ], }
參數說明
參數 | 說明 |
---|---|
errcode | 錯誤碼 |
errmsg | 錯誤信息 |
plugin_list | 申請或使用中的插件列表 |
appid | 插件appid |
status | 插件狀態(1:申請中,2:申請通過,3:被拒絕;4:已超時) |
nickname | 插件昵稱 |
headimgurl | 插件頭像 |
錯誤碼說明
錯誤碼 | 說明 |
---|---|
0 | 成功 |
-1 | 系統錯誤 |
3. 刪除已添加的插件
此接口用戶小程序刪除當前已添加的插件(包括已通過和已拒絕)
請求方式: POST(請使用https協議)
https://api.weixin.qq.com/wxa/plugin?access_token=TOKEN
POST數據示例
{ "action":"unbind" "plugin_appid":"aaaa" }
參數說明
參數 | 說明 |
---|---|
action | 填寫list |
plugin_appid | 插件appid |
返回說明(正常時返回的json示例)
{ "errcode":0, "errmsg":"ok", }
錯誤碼說明
錯誤碼 | 說明 |
---|---|
0 | 成功 |
-1 | 系統錯誤 |
89243 | 該申請為“待確認”狀態,不可刪除 |
89244 |
不存在該插件appid |
下面對其進行詳細介紹:
步驟1:第三方平臺方獲取預授權碼(pre_auth_code)
預授權碼是第三方平臺方實現授權托管的必備信息,可以通過本文
步驟2:引入用戶進入授權頁
第三方平臺方可以在自己的網站:中放置“微信公眾號授權”或者“小程序授權”的入口,引導公眾號和小程序管理員進入授權頁。
授權頁網址為:
https://mp.weixin.qq.com/cgi-bin/componentloginpage?component\_appid=xxxx&pre\_auth\_code=xxxxx&redirect\_uri=xxxx&auth\_type=xxx。
參數 | 是否必填 | 參數說明 |
---|---|---|
component_appid | 是 | 第三方平臺方appid |
pre_auth_code | 是 | 預授權碼 |
redirect_uri | 是 | 回調URI |
auth_type | 否 | 要授權的帳號類型, 1則商戶掃碼后,手機端僅展示公眾號、2表示僅展示小程序,3表示公眾號和小程序都展示。如果為未制定,則默認小程序和公眾號都展示。第三方平臺開發者可以使用本字段來控制授權的帳號類型。 |
步驟3:用戶確認并同意登錄授權給第三方平臺方
用戶進入第三方平臺授權頁后,需要確認并同意將自己的公眾號或小程序授權給第三方平臺方,完成授權流程。
步驟4:授權后回調URI,得到授權碼(authorization_code)和過期時間
授權流程完成后,授權頁會自動跳轉進入回調URI,并在URL參數中返回授權碼和過期時間(redirect_url?auth_code=xxx&expires_in=600)
步驟5:利用授權碼調用公眾號或小程序的相關API
在得到授權碼后,第三方平臺方可以使用授權碼換取授權公眾號或小程序的接口調用憑據(authorizer_access_token,也簡稱為令牌),再通過該接口調用憑據,按照公眾號開發者文檔或小程序開發文檔的說明,去調用公眾號或小程序相關API。
(能調用哪些API,取決于用戶將哪些權限集授權給了第三方平臺方,也取決于公眾號或小程序自身擁有哪些接口權限),使用JS SDK等能力。具體請見【公眾號第三方平臺的接口說明】
下面對各API和機制進行介紹(特別注意,所有API調用需要驗證調用者IP地址。只有在第三方平臺申請時填寫的白名單IP地址列表內的IP地址,才能合法調用,其他一律拒絕):
功能 | API的作用 |
---|---|
1、推送component_verify_ticket | 出于安全考慮,在第三方平臺創建審核通過后,微信服務器 每隔10分鐘會向第三方的消息接收地址推送一次component_verify_ticket,用于獲取第三方平臺接口調用憑據。 |
2、獲取第三方平臺component_access_token | 第三方平臺通過自己的component_appid(即在微信開放平臺管理中心的第三方平臺詳情頁中的AppID和AppSecret)和component_appsecret,以及component_verify_ticket(每10分鐘推送一次的安全ticket)來獲取自己的接口調用憑據(component_access_token) |
3、獲取預授權碼pre_auth_code | 第三方平臺通過自己的接口調用憑據(component_access_token)來獲取用于授權流程準備的預授權碼(pre_auth_code) |
4、使用授權碼換取公眾號或小程序的接口調用憑據和授權信息 | 通過授權碼和自己的接口調用憑據(component_access_token),換取公眾號或小程序的接口調用憑據(authorizer_access_token和用于前者快過期時用來刷新它的authorizer_refresh_token)和授權信息(授權了哪些權限等信息) |
5、獲取(刷新)授權公眾號或小程序的接口調用憑據 | 通過authorizer_refresh_token來刷新公眾號或小程序的接口調用憑據 |
6、獲取授權公眾號或小程序基本信息 | 在需要的情況下,第三方平臺可以獲取公眾號或小程序的帳號基本信息,包括帳號名、帳號類型等 |
7、獲取授權方的選項設置信息 | 在需要的情況下,第三方平臺可以獲取公眾號或小程序的選項設置,包括地理位置上報設置、語音識別開關設置、微信多客服功能開關設置 |
8、設置授權方的選項信息 | 在需要的情況下,第三方平臺可以修改上述公眾號或小程序的選項設置,包括地理位置上報設置、語音識別開關設置、微信多客服功能開關設置 |
9、推送授權相關通知 | 當公眾號或小程序對第三方進行授權、取消授權、更新授權時,將通過事件推送告訴開發者 |
接下來:代替公眾號或小程序調用接口 | 取在完成授權后,第三方平臺可通過公眾號或小程序的接口調用憑據(authorizer_access_token)來代替它調用接口,具體請見“代公眾號實現業務”和“代小程序實現業務”文件夾中的內容 |
1、推送component_verify_ticket協議
在第三方平臺創建審核通過后,微信服務器會向其“授權事件接收URL”每隔10分鐘定時推送component_verify_ticket。第三方平臺方在收到ticket推送后也需進行解密(詳細請見【消息加解密接入指引】),接收到后必須直接返回字符串success。
POST數據示例
<xml> <AppId> </AppId> <CreateTime>1413192605 </CreateTime> <InfoType> </InfoType> <ComponentVerifyTicket> </ComponentVerifyTicket> </xml>
字段說明
字段名稱 | 字段描述 |
---|---|
AppId | 第三方平臺appid |
CreateTime | 時間戳 |
InfoType | component_verify_ticket |
ComponentVerifyTicket | Ticket內容 |
注意:
component_verify_ticket的有效時間較component_access_token更長,建議保存最近可用的component_verify_ticket,在component_access_token過期之前使用該ticket進行更新,避免出現因為ticket接收失敗而無法更新component_access_token的情況。
2、獲取第三方平臺component_access_token
第三方平臺component_access_token是第三方平臺的下文中接口的調用憑據,也叫做令牌(component_access_token)。每個令牌是存在有效期(2小時)的,且令牌的調用不是無限制的,請第三方平臺做好令牌的管理,在令牌快過期時(比如1小時50分)再進行刷新。
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/api_component_token
POST數據示例:
{ "component_appid":"appid_value" , "component_appsecret": "appsecret_value", "component_verify_ticket": "ticket_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
component_appsecret | 第三方平臺appsecret |
component_verify_ticket | 微信后臺推送的ticket,此ticket會定時推送,具體請見本頁的推送說明 |
返回結果示例
{"component_access_token":"61W3mEpU66027wgNZ_MhGHNQDHnFATkDa9-2llqrMBjUwxRSNPbVsMmyD-yq8wZETSoE5NQgecigDrSHkPtIYA", "expires_in":7200}
結果參數說明
參數 | 說明 |
---|---|
component_access_token | 第三方平臺access_token |
expires_in | 有效期 |
3、獲取預授權碼pre_auth_code
該API用于獲取預授權碼。預授權碼用于公眾號或小程序授權時的第三方平臺方安全驗證。
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/api_create_preauthcode?component_access_token=xxx
POST數據示例:
{ "component_appid":"appid_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺方appid |
返回結果示例
{"pre_auth_code":"Cx_Dk6qiBE0Dmx4EmlT3oRfArPvwSQ-oa3NL_fwHM7VI08r52wazoZX2Rhpz1dEw","expires_in":600}
結果參數說明
參數 | 說明 |
---|---|
pre_auth_code | 預授權碼 |
expires_in | 有效期,為10分鐘 |
4、使用授權碼換取公眾號或小程序的接口調用憑據和授權信息
該API用于使用授權碼換取授權公眾號或小程序的授權信息,并換取authorizer_access_token和authorizer_refresh_token。 授權碼的獲取,需要在用戶在第三方平臺授權頁中完成授權流程后,在回調URI中通過URL參數提供給第三方平臺方。請注意,由于現在公眾號或小程序可以自定義選擇部分權限授權給第三方平臺,因此第三方平臺開發者需要通過該接口來獲取公眾號或小程序具體授權了哪些權限,而不是簡單地認為自己聲明的權限就是公眾號或小程序授權的權限。
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/api_query_auth?component_access_token=xxxx
POST數據示例:
{ "component_appid":"appid_value" , "authorization_code": "auth_code_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
authorization_code | 授權code,會在授權成功時返回給第三方平臺,詳見第三方平臺授權流程說明 |
返回結果示例
{ "authorization_info": { "authorizer_appid": "wxf8b4f85f3a794e77", "authorizer_access_token": "QXjUqNqfYVH0yBE1iI_7vuN_9gQbpjfK7hYwJ3P7xOa88a89-Aga5x1NMYJyB8G2yKt1KCl0nPC3W9GJzw0Zzq_dBxc8pxIGUNi_bFes0qM", "expires_in": 7200, "authorizer_refresh_token": "dTo-YCXPL4llX-u1W1pPpnp8Hgm4wpJtlR6iV0doKdY", "func_info": [ { "funcscope_category": { "id": 1 } }, { "funcscope_category": { "id": 2 } }, { "funcscope_category": { "id": 3 } } ] }}
結果參數說明
參數 | 說明 |
---|---|
authorization_info | 授權信息 |
authorizer_appid | 授權方appid |
authorizer_access_token | 授權方接口調用憑據(在授權的公眾號或小程序具備API權限時,才有此返回值),也簡稱為令牌 |
expires_in | 有效期(在授權的公眾號或小程序具備API權限時,才有此返回值) |
authorizer_refresh_token | 接口調用憑據刷新令牌(在授權的公眾號具備API權限時,才有此返回值),刷新令牌主要用于第三方平臺獲取和刷新已授權用戶的access_token,只會在授權時刻提供,請妥善保存。 一旦丟失,只能讓用戶重新授權,才能再次拿到新的刷新令牌 |
func_info | 授權給開發者的權限集列表,ID為1到26分別代表: 1、消息管理權限 2、用戶管理權限 3、帳號服務權限 4、網頁服務權限 5、微信小店權限 6、微信多客服權限 7、群發與通知權限 8、微信卡券權限 9、微信掃一掃權限 10、微信連WIFI權限 11、素材管理權限 12、微信搖周邊權限 13、微信門店權限 14、微信支付權限 15、自定義菜單權限 16、獲取認證狀態及信息 17、帳號管理權限(小程序) 18、開發管理與數據分析權限(小程序) 19、客服消息管理權限(小程序) 20、微信登錄權限(小程序) 21、數據分析權限(小程序) 22、城市服務接口權限 23、廣告管理權限 24、開放平臺帳號管理權限 25、 開放平臺帳號管理權限(小程序) 26、微信電子發票權限 請注意: 1)該字段的返回不會考慮公眾號是否具備該權限集的權限(因為可能部分具備),請根據公眾號的帳號類型和認證情況,來判斷公眾號的接口權限。 |
5、獲取(刷新)授權公眾號或小程序的接口調用憑據(令牌)
該API用于在授權方令牌(authorizer_access_token)失效時,可用刷新令牌(authorizer_refresh_token)獲取新的令牌。請注意,此處token是2小時刷新一次,開發者需要自行進行token的緩存,避免token的獲取次數達到每日的限定額度。緩存方法可以參考:http://mp.weixin.qq.com/wiki/2/88b2bf1265a707c031e51f26ca5e6512.html
當換取authorizer_refresh_token后建議保存。
接口調用請求說明
http請求方式: POST(請使用https協議) https:// api.weixin.qq.com /cgi-bin/component/api_authorizer_token?component_access_token=xxxxx
POST數據示例:
{ "component_appid":"appid_value", "authorizer_appid":"auth_appid_value", "authorizer_refresh_token":"refresh_token_value", }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
authorizer_appid | 授權方appid |
authorizer_refresh_token | 授權方的刷新令牌,刷新令牌主要用于第三方平臺獲取和刷新已授權用戶的access_token,只會在授權時刻提供,請妥善保存。一旦丟失,只能讓用戶重新授權,才能再次拿到新的刷新令牌 |
返回結果示例
{ "authorizer_access_token": "aaUl5s6kAByLwgV0BhXNuIFFUqfrR8vTATsoSHukcIGqJgrc4KmMJ-JlKoC_-NKCLBvuU1cWPv4vDcLN8Z0pn5I45mpATruU0b51hzeT1f8", "expires_in": 7200, "authorizer_refresh_token": "BstnRqgTJBXb9N2aJq6L5hzfJwP406tpfahQeLNxX0w" }
結果參數說明
參數 | 說明 |
---|---|
authorizer_access_token | 授權方令牌 |
expires_in | 有效期,為2小時 |
authorizer_refresh_token | 刷新令牌 |
6、獲取授權方的帳號基本信息
該API用于獲取授權方的基本信息,包括頭像、昵稱、帳號類型、認證類型、微信號、原始ID和二維碼圖片URL。
需要特別記錄授權方的帳號類型,在消息及事件推送時,對于不具備客服接口的公眾號,需要在5秒內立即響應;而若有客服接口,則可以選擇暫時不響應,而選擇后續通過客服接口來發送消息觸達粉絲。
(1)公眾號獲取方法如下:
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/api_get_authorizer_info?component_access_token=xxxx
POST數據示例:
{ "component_appid":"appid_value" , "authorizer_appid": "auth_appid_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
authorizer_appid | 授權方appid |
返回結果示例
{ "authorizer_info": { "nick_name": "微信SDK Demo Special", "head_img": "http://wx.qlogo.cn/mmopen/GPy", "service_type_info": { "id": 2 }, "verify_type_info": { "id": 0 }, "user_name":"gh_eb5e3a772040", "principal_name":"騰訊計算機系統有限公司", "business_info": {"open_store": 0, "open_scan": 0, "open_pay": 0, "open_card": 0, "open_shake": 0}, "alias":"paytest01" "qrcode_url":"URL", }, "authorization_info": { "authorization_appid": "wxf8b4f85f3a794e77", "func_info": [ { "funcscope_category": { "id": 1 } }, { "funcscope_category": { "id": 2 } }, { "funcscope_category": { "id": 3 } } ] } }
結果參數說明
參數 | 說明 |
---|---|
nick_name | 授權方昵稱 |
head_img | 授權方頭像 |
service_type_info | 授權方公眾號類型,0代表訂閱號,1代表由歷史老帳號升級后的訂閱號,2代表服務號 |
verify_type_info | 授權方認證類型,-1代表未認證,0代表微信認證,1代表新浪微博認證,2代表騰訊微博認證,3代表已資質認證通過但還未通過名稱認證,4代表已資質認證通過、還未通過名稱認證,但通過了新浪微博認證,5代表已資質認證通過、還未通過名稱認證,但通過了騰訊微博認證 |
user_name | 授權方公眾號的原始ID |
principal_name | 公眾號的主體名稱 |
alias | 授權方公眾號所設置的微信號,可能為空 |
business_info | 用以了解以下功能的開通狀況(0代表未開通,1代表已開通): open_store:是否開通微信門店功能 open_scan:是否開通微信掃商品功能 open_pay:是否開通微信支付功能 open_card:是否開通微信卡券功能 open_shake:是否開通微信搖一搖功能 |
qrcode_url | 二維碼圖片的URL,開發者最好自行也進行保存 |
authorization_info | 授權信息 |
authorization_appid | 授權方appid |
func_info | 公眾號授權給開發者的權限集列表,ID為1到15時分別代表: 1.消息管理權限 2.用戶管理權限 3.帳號服務權限 4.網頁服務權限 5.微信小店權限 6.微信多客服權限 7.群發與通知權限 8.微信卡券權限 9.微信掃一掃權限 10.微信連WIFI權限 11.素材管理權限 12.微信搖周邊權限 13.微信門店權限 14.微信支付權限 15.自定義菜單權限 請注意: 1)該字段的返回不會考慮公眾號是否具備該權限集的權限(因為可能部分具備),請根據公眾號的帳號類型和認證情況,來判斷公眾號的接口權限。 |
(2)小程序獲取方法如下
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/api_get_authorizer_info?component_access_token=xxxx
POST數據示例:
{ "component_appid":"appid_value" , "authorizer_appid": "auth_appid_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
authorizer_appid | 授權方appid |
返回結果示例:
{ "authorizer_info": { "nick_name": "微信SDK Demo Special", "head_img": "http://wx.qlogo.cn/mmopen/GPy", "service_type_info": { "id": 2 }, "verify_type_info": { "id": 0 }, "user_name":"gh_eb5e3a772040", "principal_name":"騰訊計算機系統有限公司", "business_info": {"open_store": 0, "open_scan": 0, "open_pay": 0, "open_card": 0, "open_shake": 0}, "qrcode_url":"URL", "signature": "時間的水緩緩流去", "MiniProgramInfo": { "network": { "RequestDomain":["https://www.qq.com","https://www.qq.com"], "WsRequestDomain":["wss://www.qq.com","wss://www.qq.com"], "UploadDomain":["https://www.qq.com","https://www.qq.com"], "DownloadDomain":["https://www.qq.com","https://www.qq.com"], }, "categories":[{"first":"資訊","second":"文娛"},{"first":"工具","second":"天氣"}], "visit_status": 0, } }, "authorization_info": { "authorization_appid": "wxf8b4f85f3a794e77", "func_info": [ { "funcscope_category": { "id": 17 } }, { "funcscope_category": { "id": 18 } }, { "funcscope_category": { "id": 19 } } ] } }
返回參數說明
參數 | 說明 |
---|---|
nick_name | 授權方昵稱 |
head_img | 授權方頭像 |
service_type_info | 默認為0 |
verify_type_info | 授權方認證類型,-1代表未認證,0代表微信認證 |
user_name | 小程序的原始ID |
signature | 帳號介紹 |
principal_name | 小程序的主體名稱 |
business_info | 用以了解以下功能的開通狀況(0代表未開通,1代表已開通): open_store:是否開通微信門店功能 open_scan:是否開通微信掃商品功能 open_pay:是否開通微信支付功能 open_card:是否開通微信卡券功能 open_shake:是否開通微信搖一搖功能 |
qrcode_url | 二維碼圖片的URL,開發者最好自行也進行保存 |
authorization_info | 授權信息 |
authorization_appid | 授權方appid |
miniprograminfo | 可根據這個字段判斷是否為小程序類型授權 |
network | 小程序已設置的各個服務器域名 |
func_info | 小程序授權給開發者的權限集列表,ID為17到19時分別代表: 17.帳號管理權限 18.開發管理權限 19.客服消息管理權限 請注意: 1)該字段的返回不會考慮小程序是否具備該權限集的權限(因為可能部分具備)。 |
7、獲取授權方的選項設置信息
該API用于獲取授權方的公眾號或小程序的選項設置信息,如:地理位置上報,語音識別開關,多客服開關。注意,獲取各項選項設置信息,需要有授權方的授權,詳見權限集說明。
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/ api_get_authorizer_option?component_access_token=xxxx
POST數據示例
{ "component_appid":"appid_value", "authorizer_appid": " auth_appid_value ", "option_name": "option_name_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
authorizer_appid | 授權公眾號或小程序的appid |
option_name | 選項名稱 |
返回結果示例
{ "authorizer_appid":"wx7bc5ba58cabd00f4", "option_name":"voice_recognize", "option_value":"1" }
結果參數說明
參數 | 說明 |
---|---|
authorizer_appid | 授權公眾號或小程序的appid |
option_name | 選項名稱 |
option_value | 選項值 |
8、設置授權方的選項信息
該API用于設置授權方的公眾號或小程序的選項信息,如:地理位置上報,語音識別開關,多客服開關。注意,設置各項選項設置信息,需要有授權方的授權,詳見權限集說明。
接口調用請求說明
http請求方式: POST(請使用https協議) https://api.weixin.qq.com/cgi-bin/component/ api_set_authorizer_option?component_access_token=xxxx
POST數據示例
{ "component_appid":"appid_value", "authorizer_appid": " auth_appid_value ", "option_name": "option_name_value", "option_value":"option_value_value" }
請求參數說明
參數 | 說明 |
---|---|
component_appid | 第三方平臺appid |
authorizer_appid | 授權公眾號或小程序的appid |
option_name | 選項名稱 |
option_value | 設置的選項值 |
返回結果示例
{ "errcode":0, "errmsg":"ok" }
結果參數說明
參數 | 說明 |
---|---|
errcode | 錯誤碼 |
errmsg | 錯誤信息 |
選項名和選項值表
option_name | option_value | 選項值說明 |
---|---|---|
location_report(地理位置上報選項) | 0 | 無上報 |
1 | 進入會話時上報 | |
2 | 每5s上報 | |
voice_recognize(語音識別開關選項) | 0 | 關閉語音識別 |
1 | 開啟語音識別 | |
customer_service(多客服開關選項) | 0 | 關閉多客服 |
1 | 開啟多客服 |
9、推送授權相關通知
當公眾號對第三方平臺進行授權、取消授權、更新授權后,微信服務器會向第三方平臺方的授權事件接收URL(創建第三方平臺時填寫)推送相關通知。
POST數據示例(授權成功通知)
<xml> <AppId>第三方平臺appid</AppId> <CreateTime>1413192760</CreateTime> <InfoType>authorized</InfoType> <AuthorizerAppid>公眾號appid</AuthorizerAppid> <AuthorizationCode>授權碼(code)</AuthorizationCode> <AuthorizationCodeExpiredTime>過期時間</AuthorizationCodeExpiredTime> <PreAuthCode>預授權碼</PreAuthCode> <xml>
POST數據示例(取消授權通知)
<xml> <AppId>第三方平臺appid</AppId> <CreateTime>1413192760</CreateTime> <InfoType>unauthorized</InfoType> <AuthorizerAppid>公眾號appid</AuthorizerAppid> </xml>
POST數據示例(授權更新通知)
<xml> <AppId>第三方平臺appid</AppId> <CreateTime>1413192760</CreateTime> <InfoType>updateauthorized</InfoType> <AuthorizerAppid>公眾號appid</AuthorizerAppid> <AuthorizationCode>授權碼(code)</AuthorizationCode> <AuthorizationCodeExpiredTime>過期時間</AuthorizationCodeExpiredTime> <PreAuthCode>預授權碼</PreAuthCode> <xml>
第三方平臺方在收到授權相關通知后也需進行解密(詳細請見【消息加解密接入指引】),接收到后之后只需直接返回字符串success。為了加強安全性,postdata中的xml將使用服務申請時的加解密key來進行加密,具體請見【公眾號第三方平臺的加密解密技術方案】
字段說明:
字段名稱 | 字段描述 |
---|---|
AppId | 第三方平臺appid |
CreateTime | 時間戳 |
InfoType | unauthorized是取消授權,updateauthorized是更新授權,authorized是授權成功通知 |
AuthorizerAppid | 公眾號或小程序 |
AuthorizationCode | 授權碼,可用于換取公眾號的接口調用憑據,詳細見上面的說明 |
AuthorizationCodeExpiredTime | 授權碼過期時間 |
PreAuthCode |
預授權碼 |
【2018微信小程序最新API接口與插件大全】資料來源于微信公眾號官方網站,如需了解最新API接口和插件,請及時登錄微信公眾號官網查看。
掃二維碼手機查看該文章