清理历史任务数据
POST
/topapi/workspace/task/clean最后修改时间:: 2 年前
责任人: 未设置
说明
调用本接口当企业解除授权后,ISV按企业清理历史任务数据。
服务地址:https://oapi.dingtalk.com
权限
服务端API是以应用维度授权的,在创建应用时,系统已默认添加了消息通知权限。
应用类型 | 是否支持调用 | 权限申请方式 | API Explorer调试 |
---|---|---|---|
企业内部应用 | 否 | — | — |
第三方企业应用 | 是 | 无需申请 | 调试 |
第三方个人应用 | 否 | — | — |
请求参数
Query 参数
accessKey
string
必需
如果是定制应用,输入定制应用的CustomKey,可在开发者后台的应用详情页获取。如果是第三方企业应用,输入第三方企业应用的SuiteKey,可在开发者后台的应用详情页获取。
示例值:
suitep1f5lzyglm7fryun
timestamp
string
必需
当前时间戳, 单位毫秒。
示例值:
1598359962000
suiteTicket
string
必需
钉钉推送的suiteTicket。定制应用可随意填写。第三方企业应用使用钉钉开放平台向应用推送的suite_ticket,请参考数据格式(biz_type=2)。suiteTicket是有有效期的,调用接口要确保从推送源中读取最新推送的suiteTicket值,一般五个小时推送一次。
示例值:
test
signature
string
必需
签名。签名计算方式请参考第三方访问接口的签名计算方法。计算出签名以后,需要进行urlencode,才能把签名参数拼接到url中。
示例值:
xxxx
Body 参数application/json
corp_id
string
必需
企业的corpid,可登录开发者后台查看。
agentid
number
可选
微应用agentId。
operator_userid
string
可选
操作者userid。
示例
{
"corp_id": "dinge8a56572fxxxx",
"agentid": 868810166,
"operator_userid": "8456259"
}
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
errcode
number
返回码。
errmsg
string
返回码描述。
示例
{
"errcode": 0,
"errmsg": "string"
}
最后修改时间: 2 年前