更新词条

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

调用本接口，更新企业词条信息。

调用本接口，可实现对已经通过审核并且生效的词条进行更新操作。

说明

更新词条后，同样需要管理员同意审核后，才能生效。

权限

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

应用类型	是否支持	权限	API Explorer调试
企业内部应用	支持	企业百科词条写权限	API Explorer
第三方企业应用	支持	企业百科词条写权限	API Explorer
第三方个人应用	暂不支持	企业百科词条写权限	暂不支持

错误码

HttpCode	错误码	错误信息	说明
400	requestError.wordName	当前传递过来的词条名称信息不能为空	当前传递过来的词条名称信息不能为空
400	paramError.request	请求的参数信息不能为空	请求的参数信息不能为空
400	paramError.wordParaphrase	释义信息不能为空	释义信息不能为空
400	paramError.corpId	获取到的企业编号不能为空	获取到的企业编号不能为空
400	paramError.uuid	词条操作主键uuid不能为空	词条操作主键uuid不能为空
400	paramError.userId	操作员工编号userId不能为空	操作员工编号userId不能为空
400	paramError.userId	操作员工编号userId填写错误未找到对应员工信息	操作员工编号userId填写错误未找到对应员工信息
400	paramError.risk	当前编辑内容安全审核未通过,存在风险词语	当前编辑内容安全审核未通过,存在风险词语
400	paramError.contactsId	当前联系人信息输入错误，请确认后再操作	当前联系人信息输入错误，请确认后再操作

curl --location --request PUT 'https://api.dingtalk.com/v1.0/pedia/words' \ --header 'x-acs-dingtalk-access-token;' \ --header 'Content-Type: application/json' \ --data-raw '{ "uuid" : Long, "wordName" : "String", "wordAlias" : [ "String" ], "highLightWordAlias" : [ "String" ], "relatedDoc" : [ { "name" : "String", "type" : "String", "link" : "String" } ], "relatedLink" : [ { "name" : "String", "link" : "String" } ], "wordParaphrase" : "String", "appLink" : [ { "appName" : "String", "pcLink" : "String", "phoneLink" : "String", "iconLink" : "String" } ], "userId" : "String", "picList" : [ { "mediaIdUrl" : "String" } ], "contactList" : [ { "userId" : "String", "nickName" : "String", "avatarMediaId" : "String" } ] }'

请求参数

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

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

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

Body 参数application/json

wordName

string

词条名称。

必需

uuid

string

必需

需要更新的词条编号。企业内部应用，可调用分页获取企业词条信息接口获取。第三方企业应用，可调用接口获取。

wordAlias

array[string]

可选

词条别名列表，最大值10。

highLightWordAlias

array[string]

可选

可高亮的别名列表，最大值10。说明高亮别名必须来自别名，否则不生效。

relatedDoc

array [object {3}]

可选

词条相关文档列表，最大值10。说明支持钉钉在线文档。

name

string

文档名称。

可选

type

string

可选

文档类型： adoc：纯文本 asheet：表格

link

string

在线文档链接。

可选

relatedLink

array [object {2}]

可选

词条相关链接列表，最大值10。

name

string

链接名称。

可选

link

string

链接地址。

可选

wordParaphrase

string

词条释义。

必需

appLink

array [object {4}]

可选

词条相关应用，最大值10。

appName

string

应用名称。

可选

pcLink

string

电脑端地址。

可选

phoneLink

string

手机端地址。

可选

iconLink

string

icon地址。

可选

userId

string

可选

操作人的userId。

picList

array [object {1}]

可选

词条的相关图片列表，最大值10。

mediaIdUrl

string

图片地址。

可选

contactList

array [object {3}]

可选

词条的相关联系人列表，最大值10。

userId

string

可选

联系人的userId。

nickName

string

联系人的昵称。

可选

avatarMediaId

string

联系人的头像地址。

可选

示例

权限#

错误码#

请求参数

返回响应

权限

错误码