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

dingtalk.oapi.card.intelligent.empgroup.send (发送小钉卡片到全员群)

提供给isv，发送全员群的小钉卡片接口。其中发送模版msgkey是我们这边配置，有管控，发送方isv，代码中也进行了管控

公共参数

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
receiver_list	String []	可选	["12312","12312"]	默认值：null 最大列表长度：999	卡片接收成员列表，不填写为全部接收
param_json	String	可选	{"haha":"enene"}	默认值：null	卡片中需要填充的参数
msg_key	String	必须	"test_key"		模版卡片注册的key
uuid	String	可选	adhfahfuoadfqe	默认值：null	卡片消息去重复，长度不能大于64

响应参数

名称	类型	示例值	描述
errcode	Number	1001	错误码
success	Boolean	true	调用接口是否成功
result	Boolean	true	业务结果
errmsg	String	系统错误	接口调用错误信息

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/card/intelligent/empgroup/send");
OapiCardIntelligentEmpgroupSendRequest req = new OapiCardIntelligentEmpgroupSendRequest();
req.setReceiverList(""12312","12312"");
req.setParamJson("{\"haha\":\"enene\"}");
req.setMsgKey("\"test_key\"");
req.setUuid("adhfahfuoadfqe");
OapiCardIntelligentEmpgroupSendResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/card/intelligent/empgroup/send");
OapiCardIntelligentEmpgroupSendRequest req = new OapiCardIntelligentEmpgroupSendRequest();
req.ReceiverList = ""12312","12312"";
req.ParamJson = "{\"haha\":\"enene\"}";
req.MsgKey = "\"test_key\"";
req.Uuid = "adhfahfuoadfqe";
OapiCardIntelligentEmpgroupSendResponse 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 OapiCardIntelligentEmpgroupSendRequest;
$req->setReceiverList("[\"12312\",\"12312\"]");
$req->setParamJson("{\"haha\":\"enene\"}");
$req->setMsgKey("\"test_key\"");
$req->setUuid("adhfahfuoadfqe");
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/card/intelligent/empgroup/send");

curl -X POST "https://oapi.dingtalk.com/topapi/card/intelligent/empgroup/send" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=a98be3d7-1be1-4b7f-b835-d9ade13e637b' \
-d 'msg_key=%5C%22test_key%5C%22' \
-d 'param_json=%7B%5C%22haha%5C%22%3A%5C%22enene%5C%22%7D' \
-d 'receiver_list=%2212312%22%2C%2212312%22' \
-d 'uuid=adhfahfuoadfqe'

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

req=dingtalk.api.OapiCardIntelligentEmpgroupSendRequest("https://oapi.dingtalk.com/topapi/card/intelligent/empgroup/send")

req.receiver_list="["12312","12312"]"
req.param_json="{\"haha\":\"enene\"}"
req.msg_key="\"test_key\""
req.uuid="adhfahfuoadfqe"
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.card.intelligent.empgroup.send");
add_param(pRequest,"receiver_list",""12312","12312"");
add_param(pRequest,"param_json","{\"haha\":\"enene\"}");
add_param(pRequest,"msg_key","\"test_key\"");
add_param(pRequest,"uuid","adhfahfuoadfqe");
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.card.intelligent.empgroup.send', {
	'receiver_list':'"12312","12312"',
	'param_json':'{\"haha\":\"enene\"}',
	'msg_key':'\"test_key\"',
	'uuid':'adhfahfuoadfqe'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "errcode":1001,
    "success":true,
    "result":true,
    "errmsg":"系统错误"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.card.intelligent.empgroup.send (发送小钉卡片到全员群)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ