Developer OpenAPI
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
首页Apifox官网钉钉openAPI
企业微信openAPI
  • openAPI文档
  • 官方文档
服务端API
  • 历史文档(不推荐)
  • 开发钉钉应用
  • 服务端API
  • 新版服务端API(DingTalk OpenAPI)
  • 生态伙伴API
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
获取凭证(access_token)身份验证(免登)应用授权通讯录管理互联平台群会话管理消息通知智能工作流智能填表智能人事考勤日志签到公告钉钉运动应用管理文件存储钉盘新教育专属钉钉智能办公电话应用市场项目管理客户管理(官方CRM)培训智能硬件
  1. 获取凭证(access_token)
  • 服务商获取第三方应用授权企业的access_token
    POST
  • 获取第三方企业应用的suite_access_token
    POST
  • 获取jsapi_ticket
    GET
  • 获取微应用后台免登的access_token
    GET
  • 获取企业内部应用的access_token
    GET
  1. 获取凭证(access_token)

获取企业内部应用的access_token

GET
http://127.0.0.1/gettoken
服务端API/获取凭证(access_token)
最后修改时间:2022-08-30 09:19:21
责任人:未设置
企业内部应用调用本接口获取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

请求参数

Header 参数
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 'http://127.0.0.1/gettoken' \
--header 'appkey: dingeqqpkv3xxxx' \
--header '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
}
上一页
获取微应用后台免登的access_token
Built with