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

dingtalk.oapi.user.getUseridByUnionid (根据unionid获取成员的userid)

根据unionid获取成员的userid

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
unionid	String	可选	1		用户在当前钉钉开放平台账号范围内的唯一标识，同一个钉钉开放平台账号可以包含多个开放应用，同时也包含ISV的套件应用及企业应用

响应参数

名称	类型	示例值	描述
errmsg	String	ok	errmsg
errcode	Number	0	errcode
contactType	Number	1	contactType
userid	String	1	userid

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/user/getUseridByUnionid");
OapiUserGetUseridByUnionidRequest req = new OapiUserGetUseridByUnionidRequest();
req.setUnionid("1");
req.setHttpMethod("GET");
OapiUserGetUseridByUnionidResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

响应示例

JSON示例

{
    "errmsg":"ok",
    "errcode":0,
    "contactType":1,
    "userid":"1"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.user.getUseridByUnionid (根据unionid获取成员的userid)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ