钉钉开发文档

开发前必读

更新时间: 2018-11-27

开发文档阅读说明

钉钉开放了丰富的服务端接口能力,开发者可以借助这些接口能力,实现企业系统与钉钉的集成打通。
调用钉钉接口时,需使用HTTPS协议、JSON数据格式、UTF8编码,访问域名为https://oapi.dingtalk.com。POST请求请在HTTP Header中设置 Content-Type:application/json。

接口说明格式如下:

请求方式:GET/POST(HTTPS)
请求地址:https://oapi.dingtalk.com/gettoken?corpid=id&corpsecret=secret
请求包体:
...
参数说明:
...
SDK请求示例:
...
返回结果:
...

1)请求方式,标明接口调用的HTTP方法,区分HttpGet/HttpPost请求。所有的请求都为HTTPS协议。
2)请求地址,接口的请求地址。
3)请求包体/参数说明,标明请求参数示例及说明,参数说明包括字段含义、取值范围。
4)SDK请求示例,使用SDK时,调用接口的代码示例。
5)返回结果/参数说明,标明返回参数示例及及说明。所有接口的返回结果里都有errcode、errmsg。开发者需根据errcode是否为0判断是否调用成功(errcode意义请见全局错误码)。而errmsg仅作参考,后续可能会有变动,因此不可作为是否调用成功的判据。

UserId机制

通过CorpId+UserId 可标识企业内唯一的一个用户,通过身份验证流程可以获取到当前用户的UserId,可以通过调用通讯录管理的获取用户详情接口来获取用户的详细信息。

关于频率限制

出于系统保护的考虑,我们对接口的调用做了频率限制。请参见“主动调用频率限制

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