微信企業號開發之如何獲取OAuth2驗證接口
作者:51CTO整理
企業應用中的URL鏈接(包括自定義菜單或者消息中的鏈接),可以通過OAuth2.0來獲取員工的身份信息。此URL的域名,必須完全匹配企業應用設置項中的'可信域名',否則獲取用戶信息時會返回50001錯誤碼。
企業應用中的URL鏈接(包括自定義菜單或者消息中的鏈接),可以通過OAuth2.0來獲取員工的身份信息。
注意,此URL的域名,必須完全匹配企業應用設置項中的'可信域名',否則獲取用戶信息時會返回50001錯誤碼。
一、企業獲取code
企業如果需要員工在跳轉到企業網頁時帶上員工的身份信息,需構造如下的鏈接:
- 參數說明
參數 | 必須 | 說明 |
---|---|---|
appid | 是 | 企業的CorpID |
redirect_uri | 是 | 授權后重定向的回調鏈接地址,請使用urlencode對鏈接進行處理 |
response_type | 是 | 返回類型,此時固定為:code |
scope | 是 | 應用授權作用域,此時固定為:snsapi_base |
state | 否 | 重定向后會帶上state參數,企業可以填寫a-zA-Z0-9的參數值 |
#wechat_redirect | 是 | 微信終端使用此參數判斷是否需要帶上身份信息 |
員工點擊后,頁面將跳轉至 redirect_uri/?code=CODE&state=STATE,企業可根據code參數獲得員工的userid。
二、獲取成員信息
- 請求說明
Https請求方式:GET
- 參數說明
參數 | 必須 | 說明 |
---|---|---|
access_token | 是 | 調用接口憑證 |
code | 是 | 通過員工授權獲取到的code,每次員工授權帶上的code將不一樣,code只能使用一次,5分鐘未被使用自動過期 |
agentid | 是 | 跳轉鏈接時所在的企業應用ID |
- 權限說明
管理員須擁有agent的使用權限;agentid必須和跳轉鏈接時所在的企業應用ID相同。
- 返回結果
a)正確時返回示例如下:
- {
- “UserId”:”USERID”
- }
參數 | 說明 |
---|---|
UserId | 員工UserID |
出錯時返回示例如下:
- {
- "errcode": "40029",
- "errmsg": "invalid code"
- }
責任編輯:閆佳明
來源:
51CTO