钉钉开放平台的服务端API是以应用维度授权的,哪些应用类型支持调用?需要申请哪些权限?是否支持API Explorer调试?
钉钉开放平台的服务端API是以应用维度授权的,支持的应用类型包括企业内部应用和第三方企业应用。在调用相关接口前,需要先申请对应的接口权限。你可以登录钉钉开放平台,选择你创建的应用,然后选择权限管理来添加相应的接口权限。如果接口申请被拒绝,可在申请栏中找到对应的接口权限,然后将鼠标移至审核未通过上查看拒绝原因。此外,如果你在调用新版服务端API时遇到无权限的错误,解决步骤是取出错误信息中AccessDeniedDetail的requiredScopes字段,表示的是当前接口所需的权限点Code。
钉钉提供了不同规范的API,DingTalk OpenAPI是全新一代的钉钉API,以资源为中心进行开放,提供更加简单、安全、高效的使用方式。调用钉钉新版规范服务端API前,需要先申请接口权限并获取API调用凭证。本文提供了API调用示例,供开发者参考https://open.dingtalk.com/document/orgapp/dingtalk-openapi-overview
钉钉开放平台的服务端API是以应用维度授权的,支持的应用类型包括企业内部应用和第三方企业应用。在调用这些API之前,需要先获取API调用凭证并申请接口权限。
为了进行API的调试,你可以使用钉钉开放平台提供的API Explorer工具。这个工具是可视化的,允许开发者在线发起API调用。在使用前,你需要用钉钉开发者账号登录到开发者后台,创建所需的应用,并在应用创建完成后复制应用的AgentId、AppKey和AppSecret以备后续使用。
要进行API的调试,首先选择你需要调试的API类目,然后在左侧菜单栏中会展示该类目下的所有开放接口列表。你也可以通过上方的搜索框进行快速检索。选择一个API后,会展示对应的API参数列表。你可以在这个界面填写API参数,然后动态生成对应的SDK示例代码。最后,将生成的代码复制到你的IDE中即可直接运行。
请注意,要使用API Explorer工具进行调试,你需要具有应用的管理权限。如果尚未获得该权限,可以联系主管理员在OA后台的子管理员权限中进行设置。
不同的应用类型需要申请不同的权限,具体如下: - 企业内部应用:成员信息读权限,以及如果需要获取手机号和邮箱等信息,还需要添加获取通讯录中手机号和邮箱的权限。 - 第三方企业应用:成员信息读权限,以及如果需要获取用户手机号、邮箱信息,可以使用钉钉统一授权套件方式获取。 - 第三方个人应用:无需申请权限。 是否支持API Explorer调试? 是,企业内部应用和第三方企业应用均支持API Explorer调试。
——此回答整理自钉群:钉钉开发者社区(互助群)
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。