淘宝开放平台

请求地址：

环境	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	必须	123		任务id
shop_code	String	必须	8028		门店code
merchant_code	String	必须	HM		商家code
face_photo	String	可选	http://		头像
body_photo	String	可选	http://		照片
rex_sid	String	必须	xxx		登陆session
risk_behavior	Number	可选	123		风险行为
trick	Number	可选	123		作案手法
task_result	Number	可选	1		结果
evidences	TaskEvidenceFileDTO []	可选		最大列表长度：999	犯罪证据
└ file_name String 可选 1 文件名 └ id String 可选 1 id └ type String 可选 image 文件类型 └ url String 可选 http 文件地址 └ upload_status Number 可选 1 上传状态
risk_happened_time	Date	可选	2020-07-01 00:00:00		作案时间
risk_type	Number	可选	1		风险类型
risk_locus	TaskRiskLocusDTO []	可选		最大列表长度：999	轨迹视频
└ time_limit String 可选 10 时间范围 └ 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 可选 123 摄像头名称 └ url String 可选 http 视频地址 └ remark String 可选 1 备注 └ upload_status Number 可选 1 上传状态 └ cameraid String 可选 1 摄像头id
hema_id	String	可选	123		会员id
comment	String	可选	asd		备注
goods	TaskSkuDTO []	可选		最大列表长度：999	作案商品
└ sku_name String 可选 1 商品名 └ unit_price String 可选 1 单价 └ number String 可选 1 数量 └ unit String 可选 1 单位 └ sku_image_url String 可选 http 商品图片 └ total_price String 可选 10 总价 └ sku_code String 可选 1 商品编号
member_id	String	可选	222		商家会员id
payer_id	String	可选	333		支付id

名称	类型	示例值	描述
result	MtopResponse	结果	结果
└ success Boolean true 结果 └ model Boolean true 结果 └ msg_info String OK 结果 └ msg_code String 200 结果

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RexIotSkyeyeRiskSubmitRequest req = new RexIotSkyeyeRiskSubmitRequest();
req.setRiskTaskCode("123");
req.setShopCode("8028");
req.setMerchantCode("HM");
req.setFacePhoto("http://");
req.setBodyPhoto("http://");
req.setRexSid("xxx");
req.setRiskBehavior(123L);
req.setTrick(123L);
req.setTaskResult(1L);
List<RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTO> list2 = new ArrayList<RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTO>();
RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTO obj3 = new RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTO();
list2.add(obj3);
obj3.setFileName("1");
obj3.setId("1");
obj3.setType("image");
obj3.setUrl("http");
obj3.setUploadStatus(1L);
req.setEvidences(list2);
req.setRiskHappenedTime(StringUtils.parseDateTime("2020-07-01 00:00:00"));
req.setRiskType(1L);
List<RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTO> list5 = new ArrayList<RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTO>();
RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTO obj6 = new RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTO();
list5.add(obj6);
obj6.setTimeLimit("10");
obj6.setLocusNumber(1L);
obj6.setStartTime(StringUtils.parseDateTime("2020-07-01 00:00:00"));
obj6.setEndTime(StringUtils.parseDateTime("2020-07-01 00:00:00"));
obj6.setCameraName("123");
obj6.setUrl("http");
obj6.setRemark("1");
obj6.setUploadStatus(1L);
obj6.setCameraid("1");
req.setRiskLocus(list5);
req.setHemaId("123");
req.setComment("asd");
List<RexIotSkyeyeRiskSubmitRequest.TaskSkuDTO> list8 = new ArrayList<RexIotSkyeyeRiskSubmitRequest.TaskSkuDTO>();
RexIotSkyeyeRiskSubmitRequest.TaskSkuDTO obj9 = new RexIotSkyeyeRiskSubmitRequest.TaskSkuDTO();
list8.add(obj9);
obj9.setSkuName("1");
obj9.setUnitPrice("1");
obj9.setNumber("1");
obj9.setUnit("1");
obj9.setSkuImageUrl("http");
obj9.setTotalPrice("10");
obj9.setSkuCode("1");
req.setGoods(list8);
req.setMemberId("222");
req.setPayerId("333");
RexIotSkyeyeRiskSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
RexIotSkyeyeRiskSubmitRequest req = new RexIotSkyeyeRiskSubmitRequest();
req.RiskTaskCode = "123";
req.ShopCode = "8028";
req.MerchantCode = "HM";
req.FacePhoto = "http://";
req.BodyPhoto = "http://";
req.RexSid = "xxx";
req.RiskBehavior = 123L;
req.Trick = 123L;
req.TaskResult = 1L;
List<RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTODomain> list2 = new List<RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTODomain>();
RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTODomain obj3 = new RexIotSkyeyeRiskSubmitRequest.TaskEvidenceFileDTODomain();
list2.Add(obj3);
obj3.FileName = "1";
obj3.Id = "1";
obj3.Type = "image";
obj3.Url = "http";
obj3.UploadStatus = 1L;
req.Evidences_ = list2;
req.RiskHappenedTime = DateTime.Parse("2020-07-01 00:00:00");
req.RiskType = 1L;
List<RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTODomain> list5 = new List<RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTODomain>();
RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTODomain obj6 = new RexIotSkyeyeRiskSubmitRequest.TaskRiskLocusDTODomain();
list5.Add(obj6);
obj6.TimeLimit = "10";
obj6.LocusNumber = 1L;
obj6.StartTime = DateTime.Parse(2020-07-01 00:00:00");
obj6.EndTime = DateTime.Parse(2020-07-01 00:00:00");
obj6.CameraName = "123";
obj6.Url = "http";
obj6.Remark = "1";
obj6.UploadStatus = 1L;
obj6.Cameraid = "1";
req.RiskLocus_ = list5;
req.HemaId = "123";
req.Comment = "asd";
List<RexIotSkyeyeRiskSubmitRequest.TaskSkuDTODomain> list8 = new List<RexIotSkyeyeRiskSubmitRequest.TaskSkuDTODomain>();
RexIotSkyeyeRiskSubmitRequest.TaskSkuDTODomain obj9 = new RexIotSkyeyeRiskSubmitRequest.TaskSkuDTODomain();
list8.Add(obj9);
obj9.SkuName = "1";
obj9.UnitPrice = "1";
obj9.Number = "1";
obj9.Unit = "1";
obj9.SkuImageUrl = "http";
obj9.TotalPrice = "10";
obj9.SkuCode = "1";
req.Goods_ = list8;
req.MemberId = "222";
req.PayerId = "333";
RexIotSkyeyeRiskSubmitResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new RexIotSkyeyeRiskSubmitRequest;
$req->setRiskTaskCode("123");
$req->setShopCode("8028");
$req->setMerchantCode("HM");
$req->setFacePhoto("http://");
$req->setBodyPhoto("http://");
$req->setRexSid("xxx");
$req->setRiskBehavior("123");
$req->setTrick("123");
$req->setTaskResult("1");
$evidences = new TaskEvidenceFileDTO;
$evidences->file_name="1";
$evidences->id="1";
$evidences->type="image";
$evidences->url="http";
$evidences->upload_status="1";
$req->setEvidences(json_encode($evidences));
$req->setRiskHappenedTime("2020-07-01 00:00:00");
$req->setRiskType("1");
$risk_locus = new TaskRiskLocusDTO;
$risk_locus->time_limit="10";
$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="123";
$risk_locus->url="http";
$risk_locus->remark="1";
$risk_locus->upload_status="1";
$risk_locus->cameraid="1";
$req->setRiskLocus(json_encode($risk_locus));
$req->setHemaId("123");
$req->setComment("asd");
$goods = new TaskSkuDTO;
$goods->sku_name="1";
$goods->unit_price="1";
$goods->number="1";
$goods->unit="1";
$goods->sku_image_url="http";
$goods->total_price="10";
$goods->sku_code="1";
$req->setGoods(json_encode($goods));
$req->setMemberId("222");
$req->setPayerId("333");
$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.rex.iot.skyeye.risk.submit' \
-d 'partner_id=apidoc' \
-d 'sign=47BCD7FA40F1BD652224DF73F6328A16' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-25+15%3A22%3A04' \
-d 'v=2.0' \
-d 'body_photo=http%3A%2F%2F' \
-d 'comment=asd' \
-d 'evidences=null' \
-d 'face_photo=http%3A%2F%2F' \
-d 'goods=null' \
-d 'hema_id=123' \
-d 'member_id=222' \
-d 'merchant_code=HM' \
-d 'payer_id=333' \
-d 'rex_sid=xxx' \
-d 'risk_behavior=123' \
-d 'risk_happened_time=2020-07-01+00%3A00%3A00' \
-d 'risk_locus=null' \
-d 'risk_task_code=123' \
-d 'risk_type=1' \
-d 'shop_code=8028' \
-d 'task_result=1' \
-d 'trick=123'

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

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

req.risk_task_code="123"
req.shop_code="8028"
req.merchant_code="HM"
req.face_photo="http://"
req.body_photo="http://"
req.rex_sid="xxx"
req.risk_behavior=123
req.trick=123
req.task_result=1
req.evidences=""
req.risk_happened_time="2020-07-01 00:00:00"
req.risk_type=1
req.risk_locus=""
req.hema_id="123"
req.comment="asd"
req.goods=""
req.member_id="222"
req.payer_id="333"
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.rex.iot.skyeye.risk.submit");
add_param(pRequest,"risk_task_code","123");
add_param(pRequest,"shop_code","8028");
add_param(pRequest,"merchant_code","HM");
add_param(pRequest,"face_photo","http://");
add_param(pRequest,"body_photo","http://");
add_param(pRequest,"rex_sid","xxx");
add_param(pRequest,"risk_behavior","123");
add_param(pRequest,"trick","123");
add_param(pRequest,"task_result","1");
add_param(pRequest,"evidences","数据结构JSON示例");
add_param(pRequest,"risk_happened_time","2020-07-01 00:00:00");
add_param(pRequest,"risk_type","1");
add_param(pRequest,"risk_locus","数据结构JSON示例");
add_param(pRequest,"hema_id","123");
add_param(pRequest,"comment","asd");
add_param(pRequest,"goods","数据结构JSON示例");
add_param(pRequest,"member_id","222");
add_param(pRequest,"payer_id","333");
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.rex.iot.skyeye.risk.submit', {
	'risk_task_code':'123',
	'shop_code':'8028',
	'merchant_code':'HM',
	'face_photo':'http://',
	'body_photo':'http://',
	'rex_sid':'xxx',
	'risk_behavior':'123',
	'trick':'123',
	'task_result':'1',
	'evidences':'数据结构JSON示例',
	'risk_happened_time':'2020-07-01 00:00:00',
	'risk_type':'1',
	'risk_locus':'数据结构JSON示例',
	'hema_id':'123',
	'comment':'asd',
	'goods':'数据结构JSON示例',
	'member_id':'222',
	'payer_id':'333'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<rex_iot_skyeye_risk_submit_response>
    <result>
        <success>true</success>
        <model>true</model>
        <msg_info>OK</msg_info>
        <msg_code>200</msg_code>
    </result>
</rex_iot_skyeye_risk_submit_response>

{
    "rex_iot_skyeye_risk_submit_response":{
        "result":{
            "success":true,
            "model":true,
            "msg_info":"OK",
            "msg_code":"200"
        }
    }
}

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.rex.iot.skyeye.risk.submit (提交风险排查有风险结果)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ