该接口用于根据code获取成员信息,适用于自建应用与代开发应用
**请求方式:**GET(**HTTPS**)
**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/auth/getuserinfo?access\_token=ACCESS\_TOKEN&code=CODE
**参数说明:**
| 参数 | 必须 | 说明 |
|--------------|-----|-------------------------------------------------------------------|
| access_token | 是 | [调用接口凭证](https://developer.work.weixin.qq.com/document/path/91023#15074) |
| code | 是 | 通过成员授权获取到的code,最大为512字节。每次成员授权带上的code将不一样,code只能使用一次,5分钟未被使用自动过期。 |
**权限说明:**
跳转的域名须完全匹配access\_token对应应用的可信域名,否则会返回50001错误。
**返回结果:**
a) 当用户为企业成员时(无论是否在应用可见范围之内)返回示例如下:
```json
{
"errcode": 0,
"errmsg": "ok",
"userid":"USERID",
"user_ticket": "USER_TICKET",
"user_doc_ticket":"USER_DOC_TICKET"
}
```
| 参数 | 说明 |
|---------------|----------------------------------------------------------------------------------------------------------------------------------|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| userid | 成员UserID。若需要获得用户详情信息,可调用通讯录接口:[读取成员](https://developer.work.weixin.qq.com/document/path/91023#10019)。如果是互联企业/企业互联/上下游,则返回的UserId格式如:CorpId/userid |
| user_ticket | 成员票据,最大为512字节,有效期为1800s。
scope为snsapi_privateinfo,且用户在应用可见范围之内时返回此参数。
后续利用该参数可以获取用户信息或敏感信息,参见["获取访问用户敏感信息"](https://developer.work.weixin.qq.com/document/path/91023#39323)。暂时不支持上下游或/企业互联场景 |
| user_doc_ticket | 文档检索票据,可在数据专区用于召回文档片段,有效期30天。`仅拥有智能专区文档存档权限的应用返回该字段(灰度内测中)` |
b) 非企业成员时,返回示例如下:
```json
{
"errcode": 0,
"errmsg": "ok",
"openid":"OPENID",
"external_userid":"EXTERNAL_USERID"
}
```
| 参数 | 说明 |
|-----------------|-----------------------------------------------------------------------------|
| errcode | 返回码 |
| errmsg | 对返回码的文本描述内容 |
| openid | 非企业成员的标识,对当前企业唯一。不超过64字节 |
| external_userid | 外部联系人id,当且仅当用户是企业的客户,且跟进人在应用的可见范围内时返回。如果是第三方应用调用,针对同一个客户,同一个服务商不同应用获取到的id相同 |
**出错返回示例:**
```json
{
"errcode": 40029,
"errmsg": "invalid code"
}
```