文档中心 > API类目 > 钉钉API

dingtalk.oapi.sso.getuserinfo (通过CODE换取微应用管理员的身份信息)

通过CODE换取微应用管理员的身份信息

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
code	String	可选	123		再次强调，此token不同于一般的accesstoken，需要调用获取微应用管理员免登需要的AccessToken
access_token	String	可选	123		通过Oauth认证给URL带上的CODE

响应参数

名称	类型	描述
user_info	UserInfo	user_info
└ avatar String avatar └ email String email └ name String name └ userid String 员工在企业内的UserID
corp_info	CorpInfo	corp_info
└ corp_name String 公司名字 └ corpid String 公司corpid
is_sys	Boolean	is_sys
errcode	Number	errcode
errmsg	String	errmsg

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/sso/getuserinfo");
OapiSsoGetuserinfoRequest req = new OapiSsoGetuserinfoRequest();
req.setCode("123");
req.setAccessToken("123");
req.setHttpMethod("GET");
OapiSsoGetuserinfoResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "user_info":{
        "avatar":"",
        "email":"",
        "name":"",
        "userid":""
    },
    "corp_info":{
        "corp_name":"",
        "corpid":""
    },
    "is_sys":,
    "errcode":,
    "errmsg":""
}

异常示例

JSON示例

{
    "error_response":{
        "msg":"Remote service error",
        "code":50,
        "sub_msg":"非法参数",
        "sub_code":"isv.invalid-parameter"
    }
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.sso.getuserinfo (通过CODE换取微应用管理员的身份信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ