Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
历史文档(不推荐)
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
HTTP回调审批待办通讯录管理钉钉红包身份验证(免登)花名册行业连接日程
HTTP回调审批待办通讯录管理钉钉红包身份验证(免登)花名册行业连接日程
  1. 身份验证(免登)
  • 通过免登码获取用户信息(不推荐)
    GET
  1. 身份验证(免登)

通过免登码获取用户信息(不推荐)

GET
http://127.0.0.1/user/getuserinfo
历史文档(不推荐)/身份验证(免登)
最后修改时间:2022-08-30 09:19:21
责任人:未设置

说明#

在第三方企业应用免登和企业内部应用免登场景中,开发者需要使用本接口通过access_token和免登接口中获取的code来获取用户userid。
服务地址:https://oapi.dingtalk.com

权限#

服务端API是以应用维度授权的,在调用接口前,确保对应用已经添加了接口权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是开发者后台申请调试
第三方企业应用是开发者后台申请调试
第三方个人应用否——

请求参数

Query 参数
access_token
string 
必需
调用服务端API的应用凭证。企业内部应用可通过获取企业内部应用的access_token接口获取。第三方企业应用可通过获取第三方企业应用的access_token接口获取。
示例值:
6ed1bxxx
code
string 
必需
免登授权码。获取方式请参考:小程序免登H5微应用免登
示例值:
677e73b724edxxxx
Body 参数application/json
object {0}
示例
{}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://127.0.0.1/user/getuserinfo?access_token=6ed1bxxx&code=677e73b724edxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{}'

返回响应

🟢200成功
application/json
Body
errcode
number 
返回码。
可选
errmsg
string 
可选
对返回码的文本描述内容。
userid
string 
可选
员工在当前企业内的唯一标识,也称staffId。
name
string 
员工姓名。
可选
deviceId
string 
设备ID。
可选
is_sys
boolean 
可选
是否是管理员。true:是false:不是
sys_level
number 
可选
级别。1:主管理员2:子管理员100:老板0:其他(如普通员工)
示例
{
  "errcode": 0,
  "errmsg": "string",
  "userid": "string",
  "name": "string",
  "deviceId": "string",
  "is_sys": true,
  "sys_level": 0
}
Built with