企业应用中的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"
- }