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