# 通过免登码获取用户信息旧版SDK

![AI 智能摘要](https://gw.alicdn.com/imgextra/i4/O1CN01Zx4PED22rkUkmRe1L_!!6000000007174-2-tps-226-40.png)![>](https://gw.alicdn.com/imgextra/i2/O1CN01UwOv1C27lrTuGFj2D_!!6000000007838-2-tps-17-30.png)

更新于 2026-07-02在第三方企业应用免登和企业内部应用免登场景中，开发者需要使用本接口通过access\_token和免登接口中获取的code来获取用户userid。

## **请求**

|    **基本信息**     |                         **基本信息**                         |
|-------------|------------------------------------------------------|
|  HTTP URL   | https://oapi.dingtalk.com/topapi/v2/user/getuserinfo |
| HTTP Method |                         POST                         |
|   支持的应用类型   |                    企业内部应用第三方企业应用                     |
|    权限要求     |                  调用企业API时需要具备的基本权限                   |

### **查询参数**

|      名称      |   类型   | 是否必填 |   示例值    |                                                描述                                                |
|--------------|--------|------|----------|--------------------------------------------------------------------------------------------------|
| access_token | String |  是   | 6ed1bxxx | 调用该API的应用凭证。

-   企业内部应用，通过获取企业内部应用的access_token接口获取。
    
-   第三方企业应用，通过获取第三方企业的access_token接口获取。 |

### **请求体**

|  名称  |   类型   | 是否必填 |          示例值          |                                               描述                                               |
|------|--------|------|-----------------------|------------------------------------------------------------------------------------------------|
| code | String |  是   | bab02f63c1e030fbbxxxx | 免登授权码，获取方式请参考：

-   小程序：getAuthCode
    
-   微应用：requestAuthCode
    

**说明**

此授权码五分钟内有效，且只能使用一次。 |

### **请求示例**

curl

1

2

3

4

curl -X POST "https://oapi.dingtalk.com/topapi/v2/user/getuserinfo" \\

\-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \\

\-d 'access\_token=417124xxxx2a3c270d5' \\

\-d 'code=123456'

Enter to Rename, ⇧Enter to Preview

Java

1

DingTalkClient client \= new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/v2/user/getuserinfo");

Enter to Rename, ⇧Enter to Preview

Python

1

# -\*- coding: utf-8 -\*-

Enter to Rename, ⇧Enter to Preview

PHP

1

include "TopSdk.php";

Enter to Rename, ⇧Enter to Preview

Node.js

1

let { Config, OapiV2UserGetuserinfoParams, OapiV2UserGetuserinfoRequest } = require('./client.js');

Enter to Rename, ⇧Enter to Preview

C#

1

IDingTalkClient client \= new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/v2/user/getuserinfo");

Enter to Rename, ⇧Enter to Preview

## **响应**

### **响应体**

|         名称         |          类型           |      示例值       |                                  描述                                  |
|--------------------|-----------------------|----------------|----------------------------------------------------------------------|
|     request_id     |        String         |  e8krly4vyiln  |                                请求ID。                                 |
|      errcode       |        Number         |       0        |                                 返回码**。**                                 |
|       errmsg       |        String         |       ok       |                             对返回码的文本描述内容。                             |
|       result       | UserGetByCodeResponse |                |                                返回结果。                                 |
|       userid       |        String         |    user456     |                              用户的userId。                              |
|     device_id      |        String         |  12drtfxxxxx   |                                设备ID。                                 |
|        sys         |        Boolean        |      true      | 是否是管理员。

-   **true**：是
    
-   **false**：不是 |
|     sys_level      |        Number         |       1        | 级别。

-   **1**：主管理员
    
-   **2**：子管理员
    
-   **100**：老板
    
-   **0**：其他（如普通员工） |
| associated_unionid |        String         |  N2o5U3axxxx   |                            用户关联的unionId。                             |
|      unionid       |        String         | gliiW002zUxxxx |                              用户unionId。                              |
|        name        |        String         |      张xx       |                                用户名字。                                 |

### **响应体示例**

1

2

3

4

5

6

7

8

9

10

11

12

13

{

  "errcode": 0, 

  "result": {

    "associated\_unionid": "N2o5U3axxxx", 

    "unionid": "gliiW0piiii02zBUjUxxxx", 

    "device\_id": "12drtfxxxxx", 

    "sys\_level": 1, 

    "name": "张xx", 

    "sys": true, 

    "userid": "userid123"

  }, 

  "errmsg": "ok"

}

Enter to Rename, ⇧Enter to Preview

### **错误码**

若调用该接口报错，可根据错误信息在[全局错误码](https://open.dingtalk.com/document/development/server-api-error-codes-1#)文档中查找解决方案。