组织云钉钉API
  1. 获取凭证(access_token)
组织云钉钉API
  • 服务端API
    • 如何调用服务端API
    • 服务端SDK下载
    • 获取凭证(access_token)
      • 获取企业内部应用的access_token
        GET
      • 获取jsapi_ticket
        GET
    • 身份验证(免登)
      • 企业内部应用免登
      • 免登常见问题
    • 通讯录管理
      • 通讯录事件
      • 用户管理
        • 创建用户
        • 更新用户信息
        • 删除用户
        • 根据userid获取用户详情
        • 获取部门用户基础信息
        • 获取部门用户userid列表
        • 获取部门用户详情
        • 获取员工人数
        • 获取未登录钉钉的员工列表
        • 根据手机号获取userid
        • 根据unionid获取用户userid
        • 获取管理员列表
        • 获取管理员通讯录权限范围
        • 获取管理员的应用管理权限
      • 部门管理
        • 获取部门详情
        • 获取部门列表
        • 获取子部门ID列表
        • 获取指定部门的所有父部门列表
        • 获取指定用户的所有父部门列表
      • 角色管理
        • 删除角色
        • 创建角色
        • 创建角色组
        • 更新角色
        • 批量增加员工角色
        • 批量删除员工角色
        • 设定角色成员管理范围
        • 获取角色组列表
        • 获取角色列表
        • 获取角色详情
        • 获取指定角色的员工列表
    • 消息通知
      • 消息通知概述
      • 消息类型与数据格式
      • 消息链接说明
      • 工作通知
        • 发送工作通知
        • 更新工作通知状态栏
        • 获取工作通知消息的发送进度
        • 获取工作通知消息的发送结果
        • 撤回工作通知消息
      • 普通消息
        • 发送普通消息
  • 钉钉回调相关
    • 钉钉Stream回调
    • 事件订阅列表
  1. 获取凭证(access_token)

获取企业内部应用的access_token

GET
/gettoken
企业内部应用第三方企业应用oapi
企业内部应用调用本接口获取access_token。调用服务端API获取应用资源时,需要通过access_token来鉴权调用者身份进行授权。
注意
官方已提供新版本的获取方式点击查看详情
在使用access_token时,请注意:
access_token的有效期为7200秒(2小时),有效期内重复获取会返回相同结果并自动续期,过期后获取会返回新的access_token。
开发者需要缓存access_token,用于后续接口的调用。因为每个应用的access_token是彼此独立的,所以进行缓存时需要区分应用来进行存储。
不能频繁调用gettoken接口,否则会受到频率拦截。

权限#

服务端API是以应用维度授权的,在调用接口前,确保已经为应用添加了接口权限。
应用类型是否支持调用权限申请方式API Explorer调试
企业内部应用是无需申请调试
第三方企业应用否——
第三方个人应用否——
在获取access_token前,需要在开发者后台查看应用的AppKey和AppSecret:
1.
登录钉钉开发者后台。
2.
在应用开发页面,单击目标应用进入应用详情页面。
3.
在基础信息页面,复制应用的AppKey和AppSecret。
注意
请妥善保管应用的AppKey和AppSecret。
p164408

请求参数

Query 参数
appkey
string 
可选
应用的唯一标识key。
示例值:
dingeqqpkv3xxxx
appsecret
string 
可选
应用的密钥。AppKey和AppSecret可在钉钉开发者后台的应用详情页面获取。
示例值:
GT-lsu-taDAsTsxx

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/gettoken?appkey=dingeqqpkv3xxxx&appsecret=GT-lsu-taDAsTsxx'

返回响应

🟢200成功
application/json
Body
expires_in
number 
可选
access_token的过期时间,单位秒。
access_token
string 
可选
生成的access_token。
errmsg
string 
返回码的描述。
可选
errcode
number 
返回码。
可选
示例
{
    "errcode": 0,
    "access_token": "96fc7a7axxx",
    "errmsg": "ok",
    "expires_in": 7200
}
修改于 2023-12-27 03:23:08
上一页
服务端SDK下载
下一页
获取jsapi_ticket
Built with