调用服务端API前需要了解哪些基础概念和调用频率限制?
调用服务端API前需要了解以下基础概念:
此外,还需要了解 API 的调用频率限制。API 提供商会限制调用频率,以保护系统稳定性。调用频率限制通常分为两类:一类是全局限制,即针对所有调用者的限制;另一类是针对单个调用者的限制。你需要注意 API 提供商给出的调用频率限制,以免超限而受到惩罚。
如何调用新版服务端API
https://open.dingtalk.com/document/orgapp/dingtalk-openapi-overview
接口调用流程
如下图所示,在调用钉钉服务端接口前,您需要完成以下准备工作:
创建一个钉钉应用,获取AppKey和AppSecret等,详情请参考应用类型介绍。
企业内部应用请参考企业内部应用的开发流程。
添加接口调用权限。
应用创建后默认只开放登录和消息通知接口的调用权限。
其他的接口权限,您需要根据开发场景,进行添加。详情请参考添加接口调用权限。
获取企业内部应用的访问凭证access_token。
根据第1步获取的AppKey和AppSecret,调用接口获取企业内部应用的accessToken,通过access_token来鉴权调用者身份。
查看各产品模块的文档,调用服务端接口。如通讯录管理,工作流概述等。
在使用钉钉调用服务端API时,需要了解以下几个基础概念和调用频率限制:
钉钉企业号(DingTalk Enterprise):每个企业都需要通过钉钉开放平台注册一个企业号,才能使用钉钉提供的各种功能和服务。
钉钉应用(DingTalk Application):钉钉应用是钉钉中的一种功能模块,可以帮助企业实现协同办公、通讯、人力资源管理等多种功能。钉钉应用可以分为标准应用、自建应用和第三方应用等多种类型。
钉钉组织架构(DingTalk Organization):钉钉组织架构是指企业在钉钉中建立的员工和部门的组织结构。通过钉钉组织架构,企业可以快速地管理和查询员工信息、部门信息等。
关于调用频率限制,有以下几点需要注意:
标准版钉钉组织,企业内部应用、委托第三方定制开发企业内部应用,每个应用调用服务端接口每秒并发的最高频次限制为20qps;当超过限制时,调用对应接口时将返回对应错误码。
标准版钉钉组织,该组织内所有企业内部应用、委托第三方定制开发企业内部应用,除不纳入每月调用量限制的接口(包括获取访问凭证接口、身份验证(免登)接口、通讯录接口等)之外,其他接口累计可调用次数调整为10000次/月。
以上是调用钉钉服务端API时需要了解的基础概念和调用频率限制,希望对你有所帮助。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。