淘宝开放平台

登录
文档中心 > API类目 > AE-商品

AE-商品

aliexpress.postproduct.redefining.findaeproductbyid (获取单个产品信息)

根据商品id查询单个商品的详细信息。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
product_id Number 可选 1307422965 商品ID

响应参数

名称 类型 示例值 描述
result AeopFindProductResultDto result
  • └ add_unit
  • Number
  • 11
  • 每增加件数.取值范围1-1000。
  • └ add_weight
  • String
  • 11.11
  • 对应增加的重量.取值范围:0.001-500.000,保留三位小数,采用进位制,单位:公斤。
  • aeop_a_e_multimedia
  • AeopAeMultimedia
  • aeopAEMultimedia":{"aeopAEVideos":[{"mediaId":30994083,"posterUrl":"http://img02.taobaocdn.com/bao/uploaded/TB16e9MJVXXXXacXVXXXXXXXXXX.jpg","mediaStatus":"approved","mediaType":"video","aliMemberId":225671041}]}
  • 商品多媒体信息，该属性主要包含商品的视频列表
  • aeop_a_e_videos
  • AeopAeVideo []
  • [ { "aliMemberId": 117284237, "mediaId": 35683461, "mediaType": "video", "mediaStatus": "approved", "posterUrl": "http://img02.taobaocdn.com/bao/uploaded/TB1a7HKLVXXXXX5XVXXXXXXXXXX.jpg" }]
  • 多媒体信息。
  • └ ali_member_id
  • Number
  • 1006680305
  • 卖家主账户ID
  • └ media_id
  • Number
  • 12345678
  • 视频ID
  • └ media_status
  • String
  • approved
  • 视频的状态
  • └ media_type
  • String
  • video
  • 视频的类型
  • └ poster_url
  • String
  • http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg
  • 视频封面图片的URL
  • aeop_ae_product_propertys
  • AeopAeProductProperty []
  • 商品的类目属性
  • └ attr_name
  • String
  • size
  • 自定义属性名属性名。 自定义属性名时,该项必填.
  • └ attr_name_id
  • Number
  • 200000043
  • 属性名ID。从类目属性接口getAttributesResultByCateId获取普通类目属性，不可填入sku属性。 自定义属性名时,该项不填.
  • └ attr_value
  • String
  • 2 - 5 kg
  • 自定义属性值。自定义属性名时,该项必填。 当自定义属性值内容为区间情况时，建议格式2 - 5 kg。(注意，数字'-'单位三者间是要加空格的！)
  • └ attr_value_end
  • String
  • 0
  • 自定义属性值的结束端
  • └ attr_value_start
  • String
  • 0
  • 自定义属性值的开始端
  • └ attr_value_unit
  • String
  • 0
  • 自定义属性值单位
  • └ attr_value_id
  • Number
  • 493
  • 属性值ID
  • aeop_ae_product_s_k_us
  • AeopAeProductSku []
  • 商品的SKU信息
  • aeop_s_k_u_property_list
  • AeopSkuProperty []
  • "aeopSKUProperty":[{"skuPropertyId":"14","propertyValueId":"771"},{"skuPropertyId":"25","propertyValueId":"775"}]
  • Sku属性对象list，允许1-3个sku属性对象，按sku属性顺序排放。sku属性从类目属性接口getAttributesResultByCateId获取。该项值输入sku属性，不能输入普通类目属性。注意，sku属性是有顺序的，必须按照顺序存放。
  • └ property_value_definition_name
  • String
  • pink
  • 属性值自定义名称
  • └ sku_image
  • String
  • http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg
  • SKU图片地址
  • └ sku_property_id
  • Number
  • 14
  • SKU属性ID
  • └ property_value_id
  • Number
  • 366
  • SKU属性值ID
  • └ image_url_list
  • String []
  • [http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg]
  • sku 套图 3:4
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • └ id
  • String
  • "200000182:193;200007763:201336100"
  • SKU ID，格式：“sku_property_id:property_value_id”
  • └ ipm_sku_stock
  • Number
  • 1234
  • SKU实际可售库存属性ipmSkuStock，该属性值的合理取值范围为0~999999，如该商品有SKU时，请确保至少有一个SKU是有货状态，也就是ipmSkuStock取值是1~999999，在整个商品纬度库存值的取值范围是1~999999。 如果同时设置了skuStock属性，那么系统以ipmSkuStock属性为优先；如果没有设置ipmSkuStock属性，那么系统会根据skuStock属性进行设置库存，true表示999，false表示0。
  • └ sku_code
  • String
  • cfas00978
  • Sku商家编码。 格式:半角英数字,长度20,不包含空格大于号和小于号。如果用户只填写零售价（productprice）和商品编码，需要完整生成一条SKU记录提交，否则商品编码无法保存。系统会认为只提交了零售价，而没有SKU，导致商品编辑未保存。
  • └ sku_price
  • String
  • 200.07
  • Sku价格。取值范围:0.01-100000;单位:美元。 如:200.07，表示:200美元7分。需要在正确的价格区间内。
  • └ sku_stock
  • Boolean
  • true
  • Sku库存,数据格式有货true，无货false；至少有一条sku记录是有货的。
  • └ barcode
  • String
  • 0
  • 条码，所有的仓发商品（尖货，自营，假发）会返回这个参数
  • aeop_s_k_u_national_discount_price_list
  • AeopSkuNationalDiscountPrice []
  • sku分国家的日常促销价
  • └ discount_price
  • String
  • 9.98
  • sku分国家的日常促销价价格
  • └ shipto_country
  • String
  • RU
  • sku分国家的日常促销价国家
  • └ sku_discount_price
  • String
  • 10.01
  • sku日常促销价
  • └ gross_weight
  • String
  • 1
  • sku重量，单位公斤
  • └ package_height
  • Number
  • 2
  • sku物流尺寸-高，单位cm
  • └ package_width
  • Number
  • 3
  • sku物流尺寸-宽，单位cm
  • └ package_length
  • Number
  • 4
  • sku物流尺寸-长，单位cm
  • └ ean_code
  • String
  • sku维度eanCode
  • └ base_unit
  • Number
  • 2
  • 自定义计重的基本产品件数
  • └ bulk_discount
  • Number
  • 90
  • 产品的批发折扣
  • └ bulk_order
  • Number
  • 10
  • 享受批发价的产品数
  • └ category_id
  • Number
  • 123456
  • 产品所在类目的ID
  • └ coupon_end_date
  • Date
  • 0
  • 卡券商品结束有效期
  • └ coupon_start_date
  • Date
  • 0
  • 卡券商品开始有效期
  • └ currency_code
  • String
  • USD
  • 产品的货币单位。美元: USD, 卢布: RUB
  • └ delivery_time
  • Number
  • 60
  • 商品的备货期
  • └ detail
  • String
  • <div></div>
  • 商品详描
  • └ gross_weight
  • String
  • 40.12
  • 产品的毛重
  • └ group_id
  • Number
  • 10023
  • 产品所关联的产品分组ID
  • └ group_ids
  • Number []
  • [1002141,10024524]
  • 产品所在的产品分组列表
  • └ image_u_r_ls
  • String
  • http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg
  • 产品的主图列表
  • └ is_image_dynamic
  • Boolean
  • true
  • 是否是动态图产品
  • └ is_pack_sell
  • Boolean
  • true
  • 是否支持是自定义计重
  • └ keyword
  • String
  • 0
  • 关键字
  • └ lot_num
  • Number
  • 1
  • 每包的数量
  • └ mobile_detail
  • String
  • balalaba
  • 商品无线详描
  • └ owner_member_id
  • String
  • aliqatest01
  • 商品拥有者的login_id
  • └ owner_member_seq
  • Number
  • 1006680305
  • 商品拥有者的ID
  • └ package_height
  • Number
  • 30
  • 产品的高度
  • └ package_length
  • Number
  • 10
  • 产品的长度
  • └ package_width
  • Number
  • 20
  • 产品的宽度
  • └ product_id
  • Number
  • 1234
  • 产品ID
  • └ product_more_keywords1
  • String
  • 0
  • productMoreKeywords1
  • └ product_more_keywords2
  • String
  • 0
  • productMoreKeywords2
  • └ product_price
  • String
  • 10.23
  • 单品产品的价格。
  • └ product_status_type
  • String
  • onSelling
  • 产品的状态，包括onSelling（正在销售），offline（已下架），auditing（审核中），editingRequired（审核不通过）
  • └ product_unit
  • Number
  • 100000015
  • 产品的单位
  • └ promise_template_id
  • Number
  • 100
  • 产品所关联的服务模版
  • └ reduce_strategy
  • String
  • place_order_withhold或payment_success_deduct
  • 库存的扣减策略
  • └ sizechart_id
  • Number
  • 123
  • 产品所关联的尺码模版ID
  • └ src
  • String
  • isv
  • 产品的来源
  • └ subject
  • String
  • knew odd
  • 产品的标题
  • └ success
  • Boolean
  • true
  • 接口调用结果
  • └ summary
  • String
  • 0
  • 商品概要
  • └ ws_display
  • String
  • expire_offline
  • 产品的下架原因，包括user_offline：手动下架，expire_offline：到期下架，punish_offline：网规处罚下架，violate_offline：交易违规下架，degrade_offline：降级下架，industry_offline：未续约下架
  • └ ws_offline_date
  • Date
  • 2018-12-19 11:24:27
  • 产品的下架日期
  • └ ws_valid_num
  • Number
  • 30
  • 产品的有效期
  • └ error_message
  • String
  • 无
  • 报错信息
  • └ error_code
  • Number
  • 16009999
  • 错误代码
  • aeop_national_quote_configuration
  • AeopNationalQuoteConfiguration
  • 商品分国家定价规则数据，建议使用新格式，请参考：https://developers.aliexpress.com/doc.htm?docId=109575&docType=1
  • └ configuration_data
  • String
  • percentage:[{"shiptoCountry":"US","percentage":"5"},{"shiptoCountry":"RU","percentage":"-2"}] relative:[{"shiptoCountry":"RU","relative":0.1},{"shiptoCountry":"US","relative":-0.1}] absolute:[{"absoluteQuoteMap":{"14:193":84.99,"14:771":84.99},"shiptoCountry":"FR"},{"absoluteQuoteMap":{"14:193":89.99,"14:771":89.99},"shiptoCountry":"ES"}]
  • jsonArray格式的分国家定价规则数据。 1)基于基准价格按比例配置的数据格式；2)基于基准价格按涨或者跌多少；3）为每个SKU直接设置价格绝对值。其中shiptoCountry：ISO两位的国家编码（目前支持国家：RU US CA ES FR UK NL IL BR CL AU UA BY JP TH SG KR ID MY PH VN IT DE SA AE PL TR）， percentage：相对于基准价的调价比例（百分比整数，支持负数，当前限制>=-30 && <=100）；configuration_type为absolute：14:193为sku属性ID：SKU属性值， 多个属性用，号拼接。
  • └ configuration_type
  • String
  • percentage, relative, absolute
  • 分国家定价规则类型[absolute: 为每个SKU直接设置价格绝对值；percentage：基于基准价格按比例配置; relative:相对原价涨或跌多少;
  • └ package_type
  • Boolean
  • true
  • 打包销售: true 非打包销售:false
  • └ gmt_modified
  • Date
  • 2018-12-18 17:11:08
  • 修改日期
  • └ gmt_create
  • Date
  • 2018-12-03 15:17:33
  • 创建日期
  • └ freight_template_id
  • Number
  • 1000
  • 产品关联的运费模版ID
  • └ dp_bulk_discount
  • Number
  • 90
  • 产品的批发折扣
  • └ dp_bulk_order
  • Number
  • 2
  • 产品的批发折扣
  • └ ext_param
  • String
  • { "custom_image": { "image": { "RU": "http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg", "BR": "http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg", "ES": "" }, "process_customized_image": true }, "vat_tags": [{ "sku_id": "200007763:201336100", "is_sku_vat_tag": true }] }
  • 扩展参数 json格式 custom_image 分国家 vat_tags 含税标
  • mode_size_chart_list
  • AeopAeModeSizeChartDto []
  • "mode_size_chart_list": [ { "mode_size": "R", "hips": "2.3", "waist": "2", "bust": "2", "height": "2" } ]
  • 模特尺码数据
  • └ hips
  • String
  • 2
  • 臀围
  • └ waist
  • String
  • 2
  • 腰围
  • └ bust
  • String
  • 2
  • 胸围
  • └ height
  • String
  • 2
  • 身高
  • └ mode_size
  • String
  • R
  • 试穿尺码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressPostproductRedefiningFindaeproductbyidRequest req = new AliexpressPostproductRedefiningFindaeproductbyidRequest();
req.setProductId(1307422965L);
AliexpressPostproductRedefiningFindaeproductbyidResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<aliexpress_postproduct_redefining_findaeproductbyid_response>
    <result>
        <add_unit>11</add_unit>
        <add_weight>11.11</add_weight>
        <aeop_a_e_multimedia>
            <aeop_a_e_videos>
                <aeop_ae_video>
                    <ali_member_id>1006680305</ali_member_id>
                    <media_id>12345678</media_id>
                    <media_status>approved</media_status>
                    <media_type>video</media_type>
                    <poster_url>http://img01.taobaocdn.com/bao/uploaded/TB1rNdGIVXXXXbTXFXXXXXXXXXX.jpg</poster_url>
                </aeop_ae_video>
            </aeop_a_e_videos>
        </aeop_a_e_multimedia>
        <aeop_ae_product_propertys>
            <aeop_ae_product_property>
                <attr_name>size</attr_name>
                <attr_name_id>200000043</attr_name_id>
                <attr_value>2 - 5 kg</attr_value>
                <attr_value_end>0</attr_value_end>
                <attr_value_start>0</attr_value_start>
                <attr_value_unit>0</attr_value_unit>
                <attr_value_id>493</attr_value_id>
            </aeop_ae_product_property>
        </aeop_ae_product_propertys>
        <aeop_ae_product_s_k_us>
            <aeop_ae_product_sku>
                <aeop_s_k_u_property_list>
                    <aeop_sku_property>
                        <property_value_definition_name>pink</property_value_definition_name>
                        <sku_image>http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg</sku_image>
                        <sku_property_id>14</sku_property_id>
                        <property_value_id>366</property_value_id>
                        <image_url_list>
                            <string>[http://ae01.alicdn.com/kf/HTB19KVYX6LuK1Rjy0Fhq6xpdFXac.jpg]</string>
                        </image_url_list>
                    </aeop_sku_property>
                </aeop_s_k_u_property_list>
                <currency_code>USD</currency_code>
                <id>&quot;200000182:193;200007763:201336100&quot;</id>
                <ipm_sku_stock>1234</ipm_sku_stock>
                <sku_code>cfas00978</sku_code>
                <sku_price>200.07</sku_price>
                <sku_stock>true</sku_stock>
                <barcode>0</barcode>
                <aeop_s_k_u_national_discount_price_list>
                    <aeop_sku_national_discount_price>
                        <discount_price>9.98</discount_price>
                        <shipto_country>RU</shipto_country>
                    </aeop_sku_national_discount_price>
                </aeop_s_k_u_national_discount_price_list>
                <sku_discount_price>10.01</sku_discount_price>
                <gross_weight>1</gross_weight>
                <package_height>2</package_height>
                <package_width>3</package_width>
                <package_length>4</package_length>
                <ean_code></ean_code>
            </aeop_ae_product_sku>
        </aeop_ae_product_s_k_us>
        <base_unit>2</base_unit>
        <bulk_discount>90</bulk_discount>
        <bulk_order>10</bulk_order>
        <category_id>123456</category_id>
        <coupon_end_date>0</coupon_end_date>
        <coupon_start_date>0</coupon_start_date>
        <currency_code>USD</currency_code>
        <delivery_time>60</delivery_time>
        <detail>&lt;div&gt;&lt;/div&gt;</detail>
        <gross_weight>40.12</gross_weight>
        <group_id>10023</group_id>
        <group_ids>
            <number>[1002141</number>
            <number>10024524]</number>
        </group_ids>
        <image_u_r_ls>http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg</image_u_r_ls>
        <is_image_dynamic>true</is_image_dynamic>
        <is_pack_sell>true</is_pack_sell>
        <keyword>0</keyword>
        <lot_num>1</lot_num>
        <mobile_detail>balalaba</mobile_detail>
        <owner_member_id>aliqatest01</owner_member_id>
        <owner_member_seq>1006680305</owner_member_seq>
        <package_height>30</package_height>
        <package_length>10</package_length>
        <package_width>20</package_width>
        <product_id>1234</product_id>
        <product_more_keywords1>0</product_more_keywords1>
        <product_more_keywords2>0</product_more_keywords2>
        <product_price>10.23</product_price>
        <product_status_type>onSelling</product_status_type>
        <product_unit>100000015</product_unit>
        <promise_template_id>100</promise_template_id>
        <reduce_strategy>place_order_withhold或payment_success_deduct</reduce_strategy>
        <sizechart_id>123</sizechart_id>
        <src>isv</src>
        <subject>knew odd</subject>
        <success>true</success>
        <summary>0</summary>
        <ws_display>expire_offline</ws_display>
        <ws_offline_date>2018-12-19 11:24:27</ws_offline_date>
        <ws_valid_num>30</ws_valid_num>
        <error_message>无</error_message>
        <error_code>16009999</error_code>
        <aeop_national_quote_configuration>
            <configuration_data>percentage:[{&quot;shiptoCountry&quot;:&quot;US&quot;,&quot;percentage&quot;:&quot;5&quot;},{&quot;shiptoCountry&quot;:&quot;RU&quot;,&quot;percentage&quot;:&quot;-2&quot;}] relative:[{&quot;shiptoCountry&quot;:&quot;RU&quot;,&quot;relative&quot;:0.1},{&quot;shiptoCountry&quot;:&quot;US&quot;,&quot;relative&quot;:-0.1}] absolute:[{&quot;absoluteQuoteMap&quot;:{&quot;14:193&quot;:84.99,&quot;14:771&quot;:84.99},&quot;shiptoCountry&quot;:&quot;FR&quot;},{&quot;absoluteQuoteMap&quot;:{&quot;14:193&quot;:89.99,&quot;14:771&quot;:89.99},&quot;shiptoCountry&quot;:&quot;ES&quot;}]</configuration_data>
            <configuration_type>percentage, relative, absolute</configuration_type>
        </aeop_national_quote_configuration>
        <package_type>true</package_type>
        <gmt_modified>2018-12-18 17:11:08</gmt_modified>
        <gmt_create>2018-12-03 15:17:33</gmt_create>
        <freight_template_id>1000</freight_template_id>
        <dp_bulk_discount>90</dp_bulk_discount>
        <dp_bulk_order>2</dp_bulk_order>
        <ext_param>{   &quot;custom_image&quot;: {     &quot;image&quot;: {       &quot;RU&quot;: &quot;http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg&quot;,       &quot;BR&quot;: &quot;http://g01.a.alicdn.com/kf/HTB13GKLJXXXXXbYaXXXq6xXFXXXi.jpg;http://g02.a.alicdn.com/kf/HTB1DkaWJXXXXXb6XFXXq6xXFXXXp.jpg;http://g02.a.alicdn.com/kf/HTB1pMCQJXXXXXcvXVXXq6xXFXXXm.jpg;http://g03.a.alicdn.com/kf/HTB1QhORJXXXXXbiXVXXq6xXFXXXx.jpg;http://g02.a.alicdn.com/kf/HTB1q1aLJXXXXXcfaXXXq6xXFXXXv.jpg&quot;,       &quot;ES&quot;: &quot;&quot;     },     &quot;process_customized_image&quot;: true   },   &quot;vat_tags&quot;: [{     &quot;sku_id&quot;: &quot;200007763:201336100&quot;,     &quot;is_sku_vat_tag&quot;: true   }] }</ext_param>
        <mode_size_chart_list>
            <aeop_ae_mode_size_chart_dto>
                <hips>2</hips>
                <waist>2</waist>
                <bust>2</bust>
                <height>2</height>
                <mode_size>R</mode_size>
            </aeop_ae_mode_size_chart_dto>
        </mode_size_chart_list>
    </result>
</aliexpress_postproduct_redefining_findaeproductbyid_response>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

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

如何获得此API

FAQ

我要提问
返回
顶部