获取企业内部应用的access_token
GET
/gettoken最后修改时间:: 2 年前
责任人: 未设置
企业内部应用调用本接口获取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:
登录钉钉开发者后台。
在应用开发页面,单击目标应用进入应用详情页面。
在基础信息页面,复制应用的AppKey和AppSecret。
注意
请妥善保管应用的AppKey和AppSecret。
请求参数
Header 参数
appkey
string
必需
应用的唯一标识key。
示例值:
dingeqqpkv3xxxx
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
expires_in
number
可选
access_token的过期时间,单位秒。
access_token
string
可选
生成的access_token。
errmsg
string
返回码的描述。
errcode
number
返回码。
示例成功示例
{
"errcode": 0,
"access_token": "96fc7a7axxx",
"errmsg": "ok",
"expires_in": 7200
}
最后修改时间: 2 年前