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

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
product_detail_request	ProductDetailQueryRequestForDistributor	必须			产品详情查询入参
└ product_id String 必须 1212312 产品 id └ include_sku Boolean 可选 true 是否查询sku信息 └ sub_channel_code String 必须 electronic_Tmall 二级渠道编码 └ channel_code String 必须 electronic 渠道编码 └ merchant_code String 可选 MCCSSJ 商家编码

名称	类型	示例值	描述
result	ResultWrapper		异步获取历史数据接口返回结果
data ProductDetailDTO {} 返回信息 product_sku_detail ProductSkuDetailDTO [] [] sku 列表 └ properties String [] [颜色:白色] sku 销售属性 └ sku_id String 4585682797025 skuId └ picture String [] [] sku图片链接 └ barcode String 1234 条码 └ reserve_price Number 100 sku一口价 └ white_bg_picture String https://img.alicdn.com:80/bao/uploaded/i1/2210944515514/O1CN011qbSZFIxMIwe4I8_!!2-item_pic.png 透明白底图 └ product_id String 63840030 产品 id └ desc_rich_text String http://img.alicdn.com:80/bao/uploaded/i1/631/400/638400304039/TB1t_Xfvkcx_u4jSZFl8qtnUFla 富文本详描 └ sales_modes String [] [dealer] 经营模式 └ sub_channel_code String tmallglobal_xxxx 二级渠道编码 └ pictures String [] [http://img.alicdn.com:80/bao/uploaded/i1/631/400/638400304039/TB1t_Xfvkcx_u4jSZFl8qtnUFla] 产品图片链接 └ product_title String 产品标题产品标题 └ properties String [] [颜色:白色] 产品销售属性 └ category String 固态硬盘类目 └ brand String xx 品牌品牌 └ channel_code String tmallglobal 渠道编码 └ brand_id String 3699037 品牌 id └ category_id String 50010803 类目 id └ materials_map String {} 素材扩展信息 └ supplier_user_id String 111 供应商userId └ product_sub_title String subTitle 子标题 └ barcode_list String [] 条码 └ tax_code String 1000 税率编码 └ tax_rate String 13 税率 └ reserve_price Number 100 一口价 └ result_success Boolean true 执行结果 └ error_message String error_message 错误码 └ error String error 错误码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpChannelDistributorProductDetailRequest req = new AlibabaAscpChannelDistributorProductDetailRequest();
AlibabaAscpChannelDistributorProductDetailRequest.ProductDetailQueryRequestForDistributor obj1 = new AlibabaAscpChannelDistributorProductDetailRequest.ProductDetailQueryRequestForDistributor();
obj1.setProductId("1212312");
obj1.setIncludeSku(true);
obj1.setSubChannelCode("electronic_Tmall");
obj1.setChannelCode("electronic");
obj1.setMerchantCode("MCCSSJ");
req.setProductDetailRequest(obj1);
AlibabaAscpChannelDistributorProductDetailResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAscpChannelDistributorProductDetailRequest req = new AlibabaAscpChannelDistributorProductDetailRequest();
AlibabaAscpChannelDistributorProductDetailRequest.ProductDetailQueryRequestForDistributorDomain obj1 = new AlibabaAscpChannelDistributorProductDetailRequest.ProductDetailQueryRequestForDistributorDomain();
obj1.ProductId = "1212312";
obj1.IncludeSku = true;
obj1.SubChannelCode = "electronic_Tmall";
obj1.ChannelCode = "electronic";
obj1.MerchantCode = "MCCSSJ";
req.ProductDetailRequest_ = obj1;
AlibabaAscpChannelDistributorProductDetailResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAscpChannelDistributorProductDetailRequest;
$product_detail_request = new ProductDetailQueryRequestForDistributor;
$product_detail_request->product_id="1212312";
$product_detail_request->include_sku="true";
$product_detail_request->sub_channel_code="electronic_Tmall";
$product_detail_request->channel_code="electronic";
$product_detail_request->merchant_code="MCCSSJ";
$req->setProductDetailRequest(json_encode($product_detail_request));
$resp = $c->execute($req, $sessionKey);

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=alibaba.ascp.channel.distributor.product.detail' \
-d 'partner_id=apidoc' \
-d 'session=e4a9d0a1-dfe1-430d-9b69-6a70ff7ebeeb' \
-d 'sign=F637D20491D5EB5FA682EAF04A3DB47B' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-18+20%3A35%3A10' \
-d 'v=2.0' \
-d 'product_detail_request=ProductDetailQueryRequestForDistributor'

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

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

req.product_detail_request="ProductDetailQueryRequestForDistributor"
try:
	resp= req.getResponse(sessionkey)
	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,"alibaba.ascp.channel.distributor.product.detail");
add_param(pRequest,"product_detail_request","数据结构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('alibaba.ascp.channel.distributor.product.detail', {
	'product_detail_request':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_ascp_channel_distributor_product_detail_response>
    <result>
        <data>
            <product_sku_detail>
                <product_sku_detail_d_t_o>
                    <properties>
                        <string>[颜色:白色]</string>
                    </properties>
                    <sku_id>4585682797025</sku_id>
                    <picture>
                        <string>[]</string>
                    </picture>
                    <barcode>1234</barcode>
                    <reserve_price>100</reserve_price>
                </product_sku_detail_d_t_o>
            </product_sku_detail>
            <white_bg_picture>https://img.alicdn.com:80/bao/uploaded/i1/2210944515514/O1CN011qbSZFIxMIwe4I8_!!2-item_pic.png</white_bg_picture>
            <product_id>63840030</product_id>
            <desc_rich_text>http://img.alicdn.com:80/bao/uploaded/i1/631/400/638400304039/TB1t_Xfvkcx_u4jSZFl8qtnUFla</desc_rich_text>
            <sales_modes>
                <string>[dealer]</string>
            </sales_modes>
            <sub_channel_code>tmallglobal_xxxx</sub_channel_code>
            <pictures>
                <string>[http://img.alicdn.com:80/bao/uploaded/i1/631/400/638400304039/TB1t_Xfvkcx_u4jSZFl8qtnUFla]</string>
            </pictures>
            <product_title>产品标题</product_title>
            <properties>
                <string>[颜色:白色]</string>
            </properties>
            <category>固态硬盘</category>
            <brand>xx 品牌</brand>
            <channel_code>tmallglobal</channel_code>
            <brand_id>3699037</brand_id>
            <category_id>50010803</category_id>
            <materials_map>{}</materials_map>
            <supplier_user_id>111</supplier_user_id>
            <product_sub_title>subTitle</product_sub_title>
            <tax_code>1000</tax_code>
            <tax_rate>13</tax_rate>
            <reserve_price>100</reserve_price>
        </data>
        <result_success>true</result_success>
        <error_message>error_message</error_message>
        <error>error</error>
    </result>
</alibaba_ascp_channel_distributor_product_detail_response>

{
    "alibaba_ascp_channel_distributor_product_detail_response":{
        "result":{
            "data":{
                "product_sku_detail":{
                    "product_sku_detail_d_t_o":[
                        {
                            "properties":{
                                "string":[
                                    "[颜色:白色]"
                                ]
                            },
                            "sku_id":"4585682797025",
                            "picture":{
                                "string":[
                                    "[]"
                                ]
                            },
                            "barcode":"1234",
                            "reserve_price":100
                        }
                    ]
                },
                "white_bg_picture":"https:\/\/img.alicdn.com:80\/bao\/uploaded\/i1\/2210944515514\/O1CN011qbSZFIxMIwe4I8_!!2-item_pic.png",
                "product_id":"63840030",
                "desc_rich_text":"http:\/\/img.alicdn.com:80\/bao\/uploaded\/i1\/631\/400\/638400304039\/TB1t_Xfvkcx_u4jSZFl8qtnUFla",
                "sales_modes":{
                    "string":[
                        "[dealer]"
                    ]
                },
                "sub_channel_code":"tmallglobal_xxxx",
                "pictures":{
                    "string":[
                        "[http:\/\/img.alicdn.com:80\/bao\/uploaded\/i1\/631\/400\/638400304039\/TB1t_Xfvkcx_u4jSZFl8qtnUFla]"
                    ]
                },
                "product_title":"产品标题",
                "properties":{
                    "string":[
                        "[颜色:白色]"
                    ]
                },
                "category":"固态硬盘",
                "brand":"xx 品牌",
                "channel_code":"tmallglobal",
                "brand_id":"3699037",
                "category_id":"50010803",
                "materials_map":"{}",
                "supplier_user_id":"111",
                "product_sub_title":"subTitle",
                "tax_code":"1000",
                "tax_rate":"13",
                "reserve_price":100
            },
            "result_success":true,
            "error_message":"error_message",
            "error":"error"
        }
    }
}

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

alibaba.ascp.channel.distributor.product.detail (获取供应链渠道中心品的详情接口（淘外分销商专用）)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

用户导航

用户反馈

用户反馈

用户反馈