淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_query_report_d_o	QueryReportDo	必须			举报查询入参
└ happen_time Number 必须 1563263816190 发生时间 └ id String 必须测试_案件唯一ID_1563263816190 案件唯一ID └ item_id Number 可选 1 商品ID └ nick String 可选无卖家昵称 └ order_id Number 可选 1100085056548470636 订单号 └ file_url String 可选 https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx 取数所需函件的可下载URL，需盖有电子签章的PDF文件 └ other_file_url String 可选 https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx 其他附件可下载的URL └ report_person String 必须测试投诉举报人姓名投诉举报人姓名 └ report_telephone String 可选测试投诉举报人手机号投诉举报人手机号 └ source String 必须测试来源机构来源机构 └ source_type String 必须测试来源类型来源类型 └ submit_person String 必须测试提交人提交人 └ text String 必须测试详细内容详细内容 └ title String 可选测试案件名称案件名称 └ illegal_content String 可选测试涉嫌违法内容涉嫌违法内容 └ illegal String 可选测试涉嫌违法点涉嫌违法点 └ register_code String 可选测试登记编号登记编号

名称	类型	示例值	描述
result	Result		接口返回model
└ code Number 1 code，1：成功；2：失败；11：重复 data ResultDo 如下返回结果 └ address String 测试认证地址认证地址 └ email String 1 待删除 └ ent_corp_name String 测试法定代表人法定代表人 └ ent_no String 统一社会信用代码或注册号统一社会信用代码或注册号 item_d_o_list ResultItemDo [] 如下商品详情列表 └ item_id Number 1 商品ID └ item_name String 测试商品名称 └ snap_shot_url String https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx 交易快照临时可下载URL └ name String 测试商家认证名称（姓名或公司名）商家认证名称（姓名或公司名） └ often_address String 测试常用地址/参考地址常用地址/参考地址 order_d_o ResultOrderDo 如下订单信息，如果没传订单ID的话，为空 └ amount String 110 订单原价 └ buy_time Number 1563264580414 下单时间 └ buyer_nick String 测试买家昵称买家昵称 └ order_id Number 1100085056548470636 订单号 └ pay_amount String 110 支付金额 └ pay_time Number 1563264580414 支付时间 └ receive_address String 测试收货地址收货地址 └ receive_time Number 1563264580414 收货时间 └ send_time Number 1563264580414 发货时间 └ phone String 测试联系电话联系电话 └ platform_type Number 0 平台类型，0：淘宝；1：天猫；2：1688 └ profession_type String PROFESSION 职业举报人标识 └ reason String 测试建议理由建议理由 └ seller_nick String 测试卖家昵称卖家昵称 └ seller_type Number 2 主体类型，1：个人；2：企业；3：个体工商 └ shop_level Number 2 店铺等级 └ shop_name String 测试店铺名称店铺名称 └ shop_status Number 0 店铺状态，0：正常；1：关店可激活；2：关店不可激活 └ shop_url String https://shop100396386.daily.taobao.net 店铺链接 └ suggest Number 1 立案建议code └ suggest_content String 建议立案立案建议说明 └ reply_url String https://files.alicdn.com/tpsservice/c0b7b319665e3ffae7b499ca0391fde4.pdf 回复函 └ message String success message

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
SungariJgbOpenReportAchieveRequest req = new SungariJgbOpenReportAchieveRequest();
SungariJgbOpenReportAchieveRequest.QueryReportDo obj1 = new SungariJgbOpenReportAchieveRequest.QueryReportDo();
obj1.setHappenTime(1563263816190L);
obj1.setId("测试_案件唯一ID_1563263816190");
obj1.setItemId(1L);
obj1.setNick("无");
obj1.setOrderId(1100085056548470636L);
obj1.setFileUrl("https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx");
obj1.setOtherFileUrl("https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx");
obj1.setReportPerson("测试投诉举报人姓名");
obj1.setReportTelephone("测试投诉举报人手机号");
obj1.setSource("测试来源机构");
obj1.setSourceType("测试来源类型");
obj1.setSubmitPerson("测试提交人");
obj1.setText("测试详细内容");
obj1.setTitle("测试案件名称");
obj1.setIllegalContent("测试涉嫌违法内容");
obj1.setIllegal("测试涉嫌违法点");
obj1.setRegisterCode("测试登记编号");
req.setParamQueryReportDO(obj1);
SungariJgbOpenReportAchieveResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
SungariJgbOpenReportAchieveRequest req = new SungariJgbOpenReportAchieveRequest();
SungariJgbOpenReportAchieveRequest.QueryReportDoDomain obj1 = new SungariJgbOpenReportAchieveRequest.QueryReportDoDomain();
obj1.HappenTime = 1563263816190L;
obj1.Id = "测试_案件唯一ID_1563263816190";
obj1.ItemId = 1L;
obj1.Nick = "无";
obj1.OrderId = 1100085056548470636L;
obj1.FileUrl = "https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx";
obj1.OtherFileUrl = "https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx";
obj1.ReportPerson = "测试投诉举报人姓名";
obj1.ReportTelephone = "测试投诉举报人手机号";
obj1.Source = "测试来源机构";
obj1.SourceType = "测试来源类型";
obj1.SubmitPerson = "测试提交人";
obj1.Text = "测试详细内容";
obj1.Title = "测试案件名称";
obj1.IllegalContent = "测试涉嫌违法内容";
obj1.Illegal = "测试涉嫌违法点";
obj1.RegisterCode = "测试登记编号";
req.ParamQueryReportDO_ = obj1;
SungariJgbOpenReportAchieveResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new SungariJgbOpenReportAchieveRequest;
$param_query_report_d_o = new QueryReportDo;
$param_query_report_d_o->happen_time="1563263816190";
$param_query_report_d_o->id="测试_案件唯一ID_1563263816190";
$param_query_report_d_o->item_id="1";
$param_query_report_d_o->nick="无";
$param_query_report_d_o->order_id="1100085056548470636";
$param_query_report_d_o->file_url="https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx";
$param_query_report_d_o->other_file_url="https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx";
$param_query_report_d_o->report_person="测试投诉举报人姓名";
$param_query_report_d_o->report_telephone="测试投诉举报人手机号";
$param_query_report_d_o->source="测试来源机构";
$param_query_report_d_o->source_type="测试来源类型";
$param_query_report_d_o->submit_person="测试提交人";
$param_query_report_d_o->text="测试详细内容";
$param_query_report_d_o->title="测试案件名称";
$param_query_report_d_o->illegal_content="测试涉嫌违法内容";
$param_query_report_d_o->illegal="测试涉嫌违法点";
$param_query_report_d_o->register_code="测试登记编号";
$req->setParamQueryReportDO(json_encode($param_query_report_d_o));
$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.sungari.jgb.open.report.achieve' \
-d 'partner_id=apidoc' \
-d 'sign=D2C2F372DC031471305F11F9266B21DD' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-23+19%3A12%3A47' \
-d 'v=2.0' \
-d 'param_query_report_d_o=null'

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

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

req.param_query_report_d_o=""
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.sungari.jgb.open.report.achieve");
add_param(pRequest,"param_query_report_d_o","数据结构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.sungari.jgb.open.report.achieve', {
	'param_query_report_d_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<sungari_jgb_open_report_achieve_response>
    <result>
        <code>1</code>
        <data>
            <address>测试认证地址</address>
            <email>1</email>
            <ent_corp_name>测试法定代表人</ent_corp_name>
            <ent_no>统一社会信用代码或注册号</ent_no>
            <item_d_o_list>
                <result_item_do>
                    <item_id>1</item_id>
                    <item_name>测试</item_name>
                    <snap_shot_url>https://files.alicdn.com/tpsservice/774e5a8011f1a3f688bc8d481dd3376a.docx</snap_shot_url>
                </result_item_do>
            </item_d_o_list>
            <name>测试商家认证名称（姓名或公司名）</name>
            <often_address>测试常用地址/参考地址</often_address>
            <order_d_o>
                <amount>110</amount>
                <buy_time>1563264580414</buy_time>
                <buyer_nick>测试买家昵称</buyer_nick>
                <order_id>1100085056548470636</order_id>
                <pay_amount>110</pay_amount>
                <pay_time>1563264580414</pay_time>
                <receive_address>测试收货地址</receive_address>
                <receive_time>1563264580414</receive_time>
                <send_time>1563264580414</send_time>
            </order_d_o>
            <phone>测试联系电话</phone>
            <platform_type>0</platform_type>
            <profession_type>PROFESSION</profession_type>
            <reason>测试建议理由</reason>
            <seller_nick>测试卖家昵称</seller_nick>
            <seller_type>2</seller_type>
            <shop_level>2</shop_level>
            <shop_name>测试店铺名称</shop_name>
            <shop_status>0</shop_status>
            <shop_url>https://shop100396386.daily.taobao.net</shop_url>
            <suggest>1</suggest>
            <suggest_content>建议立案</suggest_content>
            <reply_url>https://files.alicdn.com/tpsservice/c0b7b319665e3ffae7b499ca0391fde4.pdf</reply_url>
        </data>
        <message>success</message>
    </result>
</sungari_jgb_open_report_achieve_response>

{
    "sungari_jgb_open_report_achieve_response":{
        "result":{
            "code":1,
            "data":{
                "address":"测试认证地址",
                "email":"1",
                "ent_corp_name":"测试法定代表人",
                "ent_no":"统一社会信用代码或注册号",
                "item_d_o_list":{
                    "result_item_do":[
                        {
                            "item_id":1,
                            "item_name":"测试",
                            "snap_shot_url":"https:\/\/files.alicdn.com\/tpsservice\/774e5a8011f1a3f688bc8d481dd3376a.docx"
                        }
                    ]
                },
                "name":"测试商家认证名称（姓名或公司名）",
                "often_address":"测试常用地址\/参考地址",
                "order_d_o":{
                    "amount":"110",
                    "buy_time":1563264580414,
                    "buyer_nick":"测试买家昵称",
                    "order_id":1100085056548470636,
                    "pay_amount":"110",
                    "pay_time":1563264580414,
                    "receive_address":"测试收货地址",
                    "receive_time":1563264580414,
                    "send_time":1563264580414
                },
                "phone":"测试联系电话",
                "platform_type":0,
                "profession_type":"PROFESSION",
                "reason":"测试建议理由",
                "seller_nick":"测试卖家昵称",
                "seller_type":2,
                "shop_level":2,
                "shop_name":"测试店铺名称",
                "shop_status":0,
                "shop_url":"https:\/\/shop100396386.daily.taobao.net",
                "suggest":1,
                "suggest_content":"建议立案",
                "reply_url":"https:\/\/files.alicdn.com\/tpsservice\/c0b7b319665e3ffae7b499ca0391fde4.pdf"
            },
            "message":"success"
        }
    }
}

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.sungari.jgb.open.report.achieve (投诉举报快速处置系统-举报信息研判)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ