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

dingtalk.oapi.smartdevice.event.post (智能硬件云云对接设备数据上报)

接收第三方云平台上报的设备数据，保存到钉钉，开放给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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
device_event_vo	DeviceEventVo	可选			系统自动生成
└ topic String 可选 /xxx/xxx 默认值：/xxx/xxx 事件对应的topic └ data String 可选 {"card":"123456"} 默认值：{"card":"123456"} json格式的数据体 └ dn String 可选 12312312 默认值：12312312 设备名称 └ pk String 可选 sdx1234214 默认值：sdx1234214 产品key

响应参数

名称	类型	示例值	描述
result	Boolean	result	返回结果
success	Boolean	false	是否成功
errcode	Number	40001	错误代码
errmsg	String	系统繁忙	错误信息

请求示例

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

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartdevice/event/post");
OapiSmartdeviceEventPostRequest req = new OapiSmartdeviceEventPostRequest();
DeviceEventVo obj1 = new DeviceEventVo();
obj1.setTopic("/xxx/xxx");
obj1.setData("{\"card\":\"123456\"}");
obj1.setDn("12312312");
obj1.setPk("sdx1234214");
req.setDeviceEventVo(obj1);
OapiSmartdeviceEventPostResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

IDingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/smartdevice/event/post");
OapiSmartdeviceEventPostRequest req = new OapiSmartdeviceEventPostRequest();
OapiSmartdeviceEventPostRequest.DeviceEventVoDomain obj1 = new OapiSmartdeviceEventPostRequest.DeviceEventVoDomain();
obj1.Topic = "/xxx/xxx";
obj1.Data = "{\"card\":\"123456\"}";
obj1.Dn = "12312312";
obj1.Pk = "sdx1234214";
req.DeviceEventVo_ = obj1;
OapiSmartdeviceEventPostResponse 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 OapiSmartdeviceEventPostRequest;
$device_event_vo = new DeviceEventVo;
$device_event_vo->topic="/xxx/xxx";
$device_event_vo->data="{\"card\":\"123456\"}";
$device_event_vo->dn="12312312";
$device_event_vo->pk="sdx1234214";
$req->setDeviceEventVo($device_event_vo);
$resp = $c->execute($req, $access_token, "https://oapi.dingtalk.com/topapi/smartdevice/event/post");

curl -X POST "https://oapi.dingtalk.com/topapi/smartdevice/event/post" \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'access_token=522f6349-7728-4dcf-8b53-79f2857ebba8' \
-d 'device_event_vo=null'

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

req=dingtalk.api.OapiSmartdeviceEventPostRequest("https://oapi.dingtalk.com/topapi/smartdevice/event/post")

req.device_event_vo=""
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.smartdevice.event.post");
add_param(pRequest,"device_event_vo","数据结构JSON示例");
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.smartdevice.event.post', {
	'device_event_vo':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

JSON示例

{
    "result":result,
    "success":false,
    "errcode":40001,
    "errmsg":"系统繁忙"
}

异常示例

JSON示例

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

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

钉钉API

dingtalk.oapi.smartdevice.event.post (智能硬件云云对接设备数据上报)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ