搜索企业项目模板新版SDK

更新于 2023-05-12

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

调用本接口，按模板名字搜索项目模板信息。

在项目应用的模板列表内，企业可创建自定义模板，与下图步骤实现效果一致。

创建自定义模板后，调用本接口可获取自定义模板的详情信息，包括模板id、模板名称、模板可见性等。

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	项目应用项目读权限	API Explorer
第三方企业应用	支持	项目应用项目读权限	API Explorer
第三方个人应用	暂不支持	项目应用项目读权限	暂不支持

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

名称

类型

是否必填

描述

x-acs-dingtalk-access-token

String

是

调用该接口的访问凭证。

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

名称	类型	是否必填	描述
keyword	String	否	项目模板名称关键词。

名称	类型	描述
result	Array	返回结果对象。
id	String	模板id。
description	String	模板的描述信息。
visible	String	模板可见性。 organization：企业内公开。 involves：私有，仅模板成员可见。
isDemo	Boolean	是否为demo模板。 true：是 false：否
isDeleted	Boolean	是否已删除。 true：是 false：否
name	String	模板名称。
logo	String	模板图标地址。
created	String	创建时间，iso8601格式，例如：2022-07-29T14:55Z。
updated	String	更新时间，iso8601格式，例如：2022-07-29T14:55Z。

请求示例

HTTP

Java

Python

PHP

Node.js

返回示例

HttpCode	错误码	错误信息	说明
400	user.not.exist	user not exist	用户在当前企业中不存在
400	org.not.exist	org not exist	当前企业在Teambition中不存在
500	server.error	system error	系统内部服务错误

这篇文档是否有帮助？

本页内容