获取公告钉盘空间信息新版SDK

更新于 2023-03-03

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口，获取企业组织公告的钉盘空间信息，用于发公告时可携带附件信息。

接口调用流程

步骤一：调用本接口，获取上传附件需要的 spaceId参数值。

步骤二：为当前操作人添加权限，需要传入步骤一中的spaceId。

企业内部应用，调用添加权限接口进行授权。注意上传操作需要EDITOR（编辑者）及以上的权限，不能是DOWNLOADER或者READER权限。

步骤三：获取附件上传信息并完成上传，拿到附件id。

企业内部应用，参考获取文件上传信息接口文档「接口调用流程」中描述的三个步骤，完成附件上传。上传完成后接口返回参数中文件信息的id就是附件id。

步骤四：调用创建公告接口，传入附件id，进行公告发送。

企业内部应用，调用创建公告接口进行公告发送。

权限

要调用此API，需要以下权限之一。

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	读取钉钉公告微应用数据的权限	API Explorer
第三方企业应用	暂不支持	读取钉钉公告微应用数据的权限	暂不支持
第三方个人应用	暂不支持	读取钉钉公告微应用数据的权限	暂不支持

请求方法

Header参数

名称	类型	是否必填	描述
x-acs-dingtalk-access-token	String	是	调用该接口的访问凭证。企业内部应用，调用获取企业内部应用的accessToken接口获取。

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

企业内部应用，调用获取企业内部应用的accessToken接口获取。

Query参数

名称	类型	是否必填	描述
operationUserId	String	是	操作人userId。

返回参数

名称	类型	描述
spaceId	String	当前组织的公告对应的钉盘空间id。

示例

请求示例

HTTP

Java

Python

PHP

Node.js

返回示例

错误码

HttpCode	错误码	错误信息	说明
403	accessDenied	%s	请求被拒绝，请确认企业开通了公告微应用，并且用户id正确。
500	serviceBusy	The server is busy and unable to complete your request. Please try again later.	服务繁忙，请稍后重试。
500	internalError	The server encountered an internal error and was unable to complete your request. Please try again later.	服务内部错误，请稍后再试。

这篇文档是否有帮助？

本页内容