钉钉开发文档

获取access_token

更新时间: 2019-2-15

获取appKey和appSecret

如果已经创建过应用,可以直接查看应用详情
如果未创建过应用,可以按照如下步骤操作:
登入OA管理后台,点击“工作台”,点击“自建应用”。

image.png

跳转到开发者后台,填入应用基本信息,选择“企业内部自主开发”

image.png

选择“开发应用”这个开发模式,输入服务端出口IP等信息,完成创建应用步骤。

image.png

查看应用详情

登入OA管理后台,点击“工作台”,找到您的应用,点击“设置”按钮。

image.png

页面会跳转到开发者后台的应用详情页,点击“查看详情”,可以找到appKey和appSecret。

image.png

image.png

如果您是新创建一个应用,在创建完成后,也会自动跳转到应用详情页,可以直接获取到appKey和appSecret。

权限管理

申请权限

在应用详情页,我们提供了“权限管理”功能,您可以设置appKey对应的接口权限,比如通讯录接口权限。

image.png

设置授权范围

您还可以在权限管理页面设置“企业通讯录授权范围”,这样可以确保您调用通讯录接口的时候,可以获取到企业通讯录数据。

image.png

获取access_token

【注意】正常情况下access_token有效期为7200秒,有效期内重复获取返回相同结果,并自动续期。

请求方式:GET(HTTPS)
请求地址https://oapi.dingtalk.com/gettoken?appkey=key&appsecret=secret
参数说明

参数 参数类型 必须 说明
appkey String 应用的唯一标识key
appsecret String 应用的密钥

SDK请求示例(JAVA)

DefaultDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");
OapiGettokenRequest request = new OapiGettokenRequest();
request.setAppkey("appkey");
request.setAppsecret("appsecret");
request.setHttpMethod("GET");
OapiGettokenResponse response = client.execute(request);

返回说明

{
    "errcode": 0,
    "errmsg": "ok",
    "access_token": "fw8ef8we8f76e6f7s8df8s"
}
以上内容是否对您有帮助:
在文档使用中是否遇到以下问题(多选):
  • 内容错误
  • 更新不及时
  • 链接错误
  • 缺少代码/图片示例
  • 太简单/步骤待完善
手机号
更多建议
提交成功,感谢您的反馈!