创建荣誉勋章模板

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

调用本接口实现创建荣誉模板。

接口功能介绍

调用本接口，根据创建荣誉勋章模板人Id、荣誉勋章名称等信息，创建企业荣誉勋章模板。

说明

创建企业荣誉勋章模板，会流入钉钉后台进行审核，一般5个工作日内审核完毕。

企业每周的审核次数有限制（标准版每周10次/专业版每周20次），超过后接口会报错。如有特殊原因希望提高审核次数上限，请联系我们申请并讲明原因。

针对同一家组织，不允许并发调用本接口创建。如需批量创建，请串行逐个执行。

荣誉设计规范

为了保障勋章能够顺利上架，避免安全、法务、涉敏、涉政等问题，荣誉名称和图形设计需要注意内容规范，详情参见荣誉设计规范。

钉钉荣誉勋章规范条款

您承诺遵守《钉钉荣誉规范条款》，保证所上传的内容不违反国家法律法规，不侵犯任何第三方的合法权益，不存在违背社会公序良俗的情况。

您同意，钉钉有权对您上传的内容进行审核、作出判断，对违反本规则的内容进行处理（包括停止发布、删除等），按钉钉相关规则对您的使用钉钉进行限制。

您同意，钉钉有权基于正常运营的需要对本服务进行变更（包括升级、停止运营等），或以钉钉提供的其他服务进行替代。

钉钉有权根据正常运营的需要对本规则进行修订，如您不接受修订后的内容，请停止使用本服务，您使用的行为将视为您同意遵守本规则。

上传素材中不得包含涉黄、涉政等违规的内容（包含但不仅限于图片、文字）。

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	组织文化荣誉信息写权限	API Explorer
第三方企业应用	支持	组织文化荣誉信息写权限	API Explorer
第三方个人应用	暂不支持	组织文化荣誉信息写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
500	system.error	系统繁忙，请稍后再试	系统繁忙，请稍后再试
500	parameter.wrong	参数为空或不符合文档要求	参数为空或不符合文档要求
500	system.check.limit	剩余审核次数不足	剩余审核次数不足
500	system.image.large	图片文件大小超过限制	图片文件大小超过限制
500	system.corp.noauth	组织已认证且激活人数大于6人才可提交审核	组织已认证且激活人数大于6人才可提交审核
500	system.userNotExist	用户不在组织内	用户不在组织内
500	system.userNotAdmin	用户无权限新建荣誉勋章	用户无权限新建荣誉勋章
500	parameter.text.unsafe	文案含有敏感词	文案含有敏感词
500	parameter.media.wrong	图片等多媒体素材非钉钉media_id格式	图片等多媒体素材非钉钉media_id格式
500	parameter.text.large	荣誉勋章名称或描述长度不符合要求	荣誉勋章名称或描述长度不符合要求
500	parametar.color.wrong	荣誉勋章背景色不符合要求	荣誉勋章背景色不符合要求
500	system.freq.limit	请求频繁，创建荣誉勋章不支持并发调用	请求频繁，创建荣誉勋章不支持并发调用

curl --location --request POST 'https://api.dingtalk.com/v1.0/orgCulture/honors/templates' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "userId" : "String", "medalName" : "String", "medalDesc" : "String", "medalMediaId" : "String", "avatarFrameMediaId" : "String", "defaultBgColor" : "String" }'

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

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

第三方企业应用，调用获取第三方应用授权企业的accessToken接口获取。

Body 参数application/json

userId

string

必需

创建荣誉勋章模板的管理员所在组织的userId信息。说明需要主管理员角色或者子管理员角色。

medalName

string

必需

荣誉勋章名称。说明最大长度10字符。不支持表情图标等。

medalDesc

string

必需

荣誉勋章描述。说明最大长度30字符。不支持表情图标等。

medalMediaId

string

必需

荣誉勋章图片。企业内部应用可调用上传媒体文件接口获取出参media_id参数字段。第三方企业应用可调用上传媒体文件接口获取出参media_id参数字段。说明图片尺寸 900*900，不超过1M，支持PNG 。图片请使用钉钉媒体资源标识符media_id。

avatarFrameMediaId

string

必需

头像挂件。企业内部应用可调用上传媒体文件接口获取出参media_id参数字段。第三方企业应用可调用上传媒体文件接口获取出参media_id参数字段。说明图片尺寸 240*240，不超过1M，支持PNG。图片请使用钉钉媒体资源标识符media_id。

defaultBgColor

string

必需

背景颜色: #FFFBB4 #FFE7BC #FFDAF4 #DAF6A8 #E4D7FF #BFDFFF #B9F2D6 说明仅以上颜色可选。

示例

application/json

Body

success

boolean

接口调用是否成功。

必需

result

object

荣誉勋章创建结果。

必需

honorId

string

荣誉勋章模板Id。

必需

创建荣誉勋章模板

接口功能介绍#

荣誉设计规范#

钉钉荣誉勋章规范条款#

权限#

错误码#

请求参数

返回响应

接口功能介绍

荣誉设计规范

钉钉荣誉勋章规范条款

权限

错误码