钉钉 API

删除词条

DELETE

/v1.0/pedia/words

调用本接口，删除词条。

说明

调用本接口删除词条后，有3秒缓存。

权限

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

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

错误码

HttpCode	错误码	错误信息	说明
400	paramError.corpId	获取到的企业编号不能为空	获取到的企业编号不能为空
400	paramError.uuid	词条操作主键uuid不能为空	词条操作主键uuid不能为空
400	paramError.userId	操作员工编号userId不能为空	操作员工编号userId不能为空
400	paramError.userId	操作员工编号userId填写错误未找到对应员工信息	操作员工编号userId填写错误未找到对应员工信息
400	paramError.uuid	当前词条不存在，请确认后uuid后再操作	当前词条不存在，请确认后uuid后再操作
400	paramError.userId	当前操作人员不是管理员,只有管理员可以进行该操作	当前操作人员不是管理员,只有管理员可以进行该操作

请求示例

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.dingtalk.com/v1.0/pedia/words?uuid=Long&userId=String' \
--header 'x-acs-dingtalk-access-token;'

响应示例

{
  "uuid": 0,
  "success": true
}

请求参数

Query 参数

uuid

string

必需

当前需要删除的词条主键编号。

企业内部应用，可调用分页获取企业词条信息接口获取。
第三方企业应用，可调用分页获取企业词条信息接口获取。

示例值:

Long

userId

string

必需

当前操作用户的userId。

示例值:

String

Header 参数

x-acs-dingtalk-access-token

string

必需

调用该接口的访问凭证。

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

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

返回响应

🟢200成功

application/json

Body

uuid

integer

必需

删除成功，返回删除的uuid。

success

boolean

必需

请求是否成功，true表示成功。

修改于 2024-01-17 08:37:33

更新词条

分页获取企业词条信息

删除词条

权限#

错误码#

请求参数

返回响应

权限

错误码