文档中心 > API类目 > 钉钉API

dingtalk.oapi.blackboard.delete (根据公告id删除公告)

根据公告id删除企业公告，只有以下身份可以删除 1、主管理员 2、公告子管理员并且是待删除公告创建者

公共参数

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

名称	类型	是否必须	描述
access_token	String	是	钉钉提供的授权Token，想了解详情，ISV开发者请点击这里，企业开发者请点击这里。若有疑问，咨询邮箱dingding_open_dingtalk#list.alibaba-inc.com。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
blackboard_id	String	必须	098uyg65ffytr43		公告id,可以通过https://oapi.dingtalk.com/blackboard/listids获取有效值
operation_userid	String	必须	manager01		操作人userId(必须是公告管理员)

响应参数

名称	类型	示例值	描述
result	Boolean		success为true时，该值不为空，否则值为空
success	Boolean	false	本次调用是否成功，该值为false时，根据errcode和errMsg排查失败原因
errcode	Number	400001	请求失败返回的错误码
errmsg	String	系统错误	请求失败返回的错误信息

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/blackboard/delete");
OapiBlackboardDeleteRequest req = new OapiBlackboardDeleteRequest();
req.setBlackboardId("098uyg65ffytr43");
req.setOperationUserid("manager01");
OapiBlackboardDeleteResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/blackboard/delete");
OapiBlackboardDeleteRequest req = new OapiBlackboardDeleteRequest();
req.BlackboardId = "098uyg65ffytr43";
req.OperationUserid = "manager01";
OapiBlackboardDeleteResponse rsp = client.Execute(req, access_token);
Console.WriteLine(rsp.Body);

include "TopSdk.php";
date_default_timezone_set('Asia/Shanghai');

$c = new DingTalkClient(DingTalkConstant::$CALL_TYPE_OAPI, DingTalkConstant::$METHOD_POST , DingTalkConstant::$FORMAT_JSON);
$req = new OapiBlackboardDeleteRequest;
$req->setBlackboardId("098uyg65ffytr43");
$req->setOperationUserid("manager01");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/blackboard/delete");

curl -X POST "https://oapi.dingtalk.com/topapi/blackboard/delete" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=40dd461d-c0fd-4212-98d3-14f353f61788' \
-d 'blackboard_id=098uyg65ffytr43' \
-d 'operation_userid=manager01'

# -*- coding: utf-8 -*-
import dingtalk.api

req=dingtalk.api.OapiBlackboardDeleteRequest("https://oapi.dingtalk.com/topapi/blackboard/delete")

req.blackboard_id="098uyg65ffytr43"
req.operation_userid="manager01"
try:
	resp= req.getResponse(access_token)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"dingtalk.oapi.blackboard.delete");
add_param(pRequest,"blackboard_id","098uyg65ffytr43");
add_param(pRequest,"operation_userid","manager01");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('dingtalk.oapi.blackboard.delete', {
	'blackboard_id':'098uyg65ffytr43',
	'operation_userid':'manager01'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":,
    "success":false,
    "errcode":400001,
    "errmsg":"系统错误"
}

异常示例

JSON示例

{
	"errcode":88,
	"errmsg":"ding talk error"
}

错误码解释

错误码	错误描述	解决方案

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

用户反馈

亲，您还没填写反馈内容。

联系方式

亲，电话号码格式不正确。

验证码刷新
亲，验证码错啦！

提交反馈

用户反馈

感谢您的反馈！

用户反馈

网络异常，请重新提交！
重新提交

钉钉API

dingtalk.oapi.blackboard.delete (根据公告id删除公告)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈