阿里安全开放平台-阿里聚安全

请求地址：

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

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
risk_task_code	String	可选	1234		任务id
hema_id	String	可选	test		盒马会员id
risk_behavior	Number	可选	1		风险行为
trick	Number	可选	1		手法
comment	String	可选	test		评论
risk_type	Number	可选	1		风险类型
face_photo	String	可选	test		人脸照片
body_photo	String	可选	test		身体照片
risk_happened_time	Date	可选	2020-07-01 00:00:00		风险发生时间
task_result	Number	可选	1		任务结果
goods	SkuDto []	可选		最大列表长度：999	商品信息
└ sku_name String 可选 test sku名称 └ unit_price String 可选 10 单价 └ number String 可选 1 数量 └ unit String 可选个单位 └ sku_image_url String 可选 test 图片地址 └ total_price String 可选 10 总价格 └ sku_code String 可选 test sku编码
evidences	EvidenceFileDto []	可选		最大列表长度：999	证据信息
└ file_name String 可选 test 文件名 └ id String 可选 1 id └ type String 可选 image 类型 └ url String 可选 test url └ upload_status Number 可选 1 视频状态
risk_locus	RiskLocusDto []	可选		最大列表长度：999	轨迹信息
└ time_limit String 可选 00:30:00 时长 └ locus_number Number 可选 1 轨迹编号 └ start_time Date 可选 2020-07-01 00:00:00 开始时间 └ end_time Date 可选 2020-07-01 00:00:00 结束时间 └ camera_name String 可选 test 摄像头名称 └ url String 可选 test 文件OSS地址 └ remark String 可选 test 备注 └ upload_status Number 可选 1 视频状态 └ cameraid String 可选 1 视频id

名称	类型	示例值	描述
result	Result		接口返回model
└ total Number 系统自动生成 └ success Boolean false 是否成功 └ err_code Number 系统自动生成 └ err_msg String 系统自动生成

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
WdkIotSkyeyeRiskSubmitRequest req = new WdkIotSkyeyeRiskSubmitRequest();
req.setRiskTaskCode("1234");
req.setHemaId("test");
req.setRiskBehavior(1L);
req.setTrick(1L);
req.setComment("test");
req.setRiskType(1L);
req.setFacePhoto("test");
req.setBodyPhoto("test");
req.setRiskHappenedTime(StringUtils.parseDateTime("2020-07-01 00:00:00"));
req.setTaskResult(1L);
List<WdkIotSkyeyeRiskSubmitRequest.SkuDto> list2 = new ArrayList<WdkIotSkyeyeRiskSubmitRequest.SkuDto>();
WdkIotSkyeyeRiskSubmitRequest.SkuDto obj3 = new WdkIotSkyeyeRiskSubmitRequest.SkuDto();
list2.add(obj3);
obj3.setSkuName("test");
obj3.setUnitPrice("10");
obj3.setNumber("1");
obj3.setUnit("个");
obj3.setSkuImageUrl("test");
obj3.setTotalPrice("10");
obj3.setSkuCode("test");
req.setGoods(list2);
List<WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDto> list5 = new ArrayList<WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDto>();
WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDto obj6 = new WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDto();
list5.add(obj6);
obj6.setFileName("test");
obj6.setId("1");
obj6.setType("image");
obj6.setUrl("test");
obj6.setUploadStatus(1L);
req.setEvidences(list5);
List<WdkIotSkyeyeRiskSubmitRequest.RiskLocusDto> list8 = new ArrayList<WdkIotSkyeyeRiskSubmitRequest.RiskLocusDto>();
WdkIotSkyeyeRiskSubmitRequest.RiskLocusDto obj9 = new WdkIotSkyeyeRiskSubmitRequest.RiskLocusDto();
list8.add(obj9);
obj9.setTimeLimit("00:30:00");
obj9.setLocusNumber(1L);
obj9.setStartTime(StringUtils.parseDateTime("2020-07-01 00:00:00"));
obj9.setEndTime(StringUtils.parseDateTime("2020-07-01 00:00:00"));
obj9.setCameraName("test");
obj9.setUrl("test");
obj9.setRemark("test");
obj9.setUploadStatus(1L);
obj9.setCameraid("1");
req.setRiskLocus(list8);
WdkIotSkyeyeRiskSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
WdkIotSkyeyeRiskSubmitRequest req = new WdkIotSkyeyeRiskSubmitRequest();
req.RiskTaskCode = "1234";
req.HemaId = "test";
req.RiskBehavior = 1L;
req.Trick = 1L;
req.Comment = "test";
req.RiskType = 1L;
req.FacePhoto = "test";
req.BodyPhoto = "test";
req.RiskHappenedTime = DateTime.Parse("2020-07-01 00:00:00");
req.TaskResult = 1L;
List<WdkIotSkyeyeRiskSubmitRequest.SkuDtoDomain> list2 = new List<WdkIotSkyeyeRiskSubmitRequest.SkuDtoDomain>();
WdkIotSkyeyeRiskSubmitRequest.SkuDtoDomain obj3 = new WdkIotSkyeyeRiskSubmitRequest.SkuDtoDomain();
list2.Add(obj3);
obj3.SkuName = "test";
obj3.UnitPrice = "10";
obj3.Number = "1";
obj3.Unit = "个";
obj3.SkuImageUrl = "test";
obj3.TotalPrice = "10";
obj3.SkuCode = "test";
req.Goods_ = list2;
List<WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDtoDomain> list5 = new List<WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDtoDomain>();
WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDtoDomain obj6 = new WdkIotSkyeyeRiskSubmitRequest.EvidenceFileDtoDomain();
list5.Add(obj6);
obj6.FileName = "test";
obj6.Id = "1";
obj6.Type = "image";
obj6.Url = "test";
obj6.UploadStatus = 1L;
req.Evidences_ = list5;
List<WdkIotSkyeyeRiskSubmitRequest.RiskLocusDtoDomain> list8 = new List<WdkIotSkyeyeRiskSubmitRequest.RiskLocusDtoDomain>();
WdkIotSkyeyeRiskSubmitRequest.RiskLocusDtoDomain obj9 = new WdkIotSkyeyeRiskSubmitRequest.RiskLocusDtoDomain();
list8.Add(obj9);
obj9.TimeLimit = "00:30:00";
obj9.LocusNumber = 1L;
obj9.StartTime = DateTime.Parse(2020-07-01 00:00:00");
obj9.EndTime = DateTime.Parse(2020-07-01 00:00:00");
obj9.CameraName = "test";
obj9.Url = "test";
obj9.Remark = "test";
obj9.UploadStatus = 1L;
obj9.Cameraid = "1";
req.RiskLocus_ = list8;
WdkIotSkyeyeRiskSubmitResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new WdkIotSkyeyeRiskSubmitRequest;
$req->setRiskTaskCode("1234");
$req->setHemaId("test");
$req->setRiskBehavior("1");
$req->setTrick("1");
$req->setComment("test");
$req->setRiskType("1");
$req->setFacePhoto("test");
$req->setBodyPhoto("test");
$req->setRiskHappenedTime("2020-07-01 00:00:00");
$req->setTaskResult("1");
$goods = new SkuDto;
$goods->sku_name="test";
$goods->unit_price="10";
$goods->number="1";
$goods->unit="个";
$goods->sku_image_url="test";
$goods->total_price="10";
$goods->sku_code="test";
$req->setGoods(json_encode($goods));
$evidences = new EvidenceFileDto;
$evidences->file_name="test";
$evidences->id="1";
$evidences->type="image";
$evidences->url="test";
$evidences->upload_status="1";
$req->setEvidences(json_encode($evidences));
$risk_locus = new RiskLocusDto;
$risk_locus->time_limit="00:30:00";
$risk_locus->locus_number="1";
$risk_locus->start_time="2020-07-01 00:00:00";
$risk_locus->end_time="2020-07-01 00:00:00";
$risk_locus->camera_name="test";
$risk_locus->url="test";
$risk_locus->remark="test";
$risk_locus->upload_status="1";
$risk_locus->cameraid="1";
$req->setRiskLocus(json_encode($risk_locus));
$resp = $c->execute($req);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.wdk.iot.skyeye.risk.submit' \
-d 'partner_id=apidoc' \
-d 'sign=05897705E685A32BA5C0A6F694E7998D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-02+20%3A56%3A22' \
-d 'v=2.0' \
-d 'body_photo=test' \
-d 'comment=test' \
-d 'evidences=null' \
-d 'face_photo=test' \
-d 'goods=null' \
-d 'hema_id=test' \
-d 'risk_behavior=1' \
-d 'risk_happened_time=2020-07-01+00%3A00%3A00' \
-d 'risk_locus=null' \
-d 'risk_task_code=1234' \
-d 'risk_type=1' \
-d 'task_result=1' \
-d 'trick=1'

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

req=top.api.WdkIotSkyeyeRiskSubmitRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.risk_task_code="1234"
req.hema_id="test"
req.risk_behavior=1
req.trick=1
req.comment="test"
req.risk_type=1
req.face_photo="test"
req.body_photo="test"
req.risk_happened_time="2020-07-01 00:00:00"
req.task_result=1
req.goods=""
req.evidences=""
req.risk_locus=""
try:
	resp= req.getResponse()
	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,"taobao.wdk.iot.skyeye.risk.submit");
add_param(pRequest,"risk_task_code","1234");
add_param(pRequest,"hema_id","test");
add_param(pRequest,"risk_behavior","1");
add_param(pRequest,"trick","1");
add_param(pRequest,"comment","test");
add_param(pRequest,"risk_type","1");
add_param(pRequest,"face_photo","test");
add_param(pRequest,"body_photo","test");
add_param(pRequest,"risk_happened_time","2020-07-01 00:00:00");
add_param(pRequest,"task_result","1");
add_param(pRequest,"goods","数据结构JSON示例");
add_param(pRequest,"evidences","数据结构JSON示例");
add_param(pRequest,"risk_locus","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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('taobao.wdk.iot.skyeye.risk.submit', {
	'risk_task_code':'1234',
	'hema_id':'test',
	'risk_behavior':'1',
	'trick':'1',
	'comment':'test',
	'risk_type':'1',
	'face_photo':'test',
	'body_photo':'test',
	'risk_happened_time':'2020-07-01 00:00:00',
	'task_result':'1',
	'goods':'数据结构JSON示例',
	'evidences':'数据结构JSON示例',
	'risk_locus':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<wdk_iot_skyeye_risk_submit_response>
    <result>
        <total></total>
        <success>false</success>
        <err_code></err_code>
        <err_msg></err_msg>
    </result>
</wdk_iot_skyeye_risk_submit_response>

{
    "wdk_iot_skyeye_risk_submit_response":{
        "result":{
            "total":,
            "success":false,
            "err_code":,
            "err_msg":""
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

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

五道口API

taobao.wdk.iot.skyeye.risk.submit (风险任务有风险提交资损记录)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈