车型属性跟其他类目属性一样,是挂载在类目下的基本属性之一,目前速卖通车型库为6层级联结构,分别是Country>>Make>>Model>>Year>>Trim>>Engine,获取到第一个层级之后才可以获取选下一层级,依次到最后一级。
所有类目下挂载的车型库是同一个,因此通过类目接口获取的车型数据是一样的
使用aliexpress.category.redefining.getchildattributesresultbypostcateidandpath( 根据发布类目id、父属性路径(可选)获取子属性信息 )获取类目属性(包含车型属性)
只传param1获取类目的一级属性,
同时传param1和param2获取类目的级联属性,每一次查询只能获取一层属性
名称 | 示例值 | 描述 |
---|---|---|
param1 | 200000219 | 叶子类目id,只传类目id,则只返回一级属性。二级及之后层级的属性,需要传param2去一一获取 |
param2 | 231208804=361443 | 类目子属性路径,由该子属性上层的类目属性id和类目属性值id组成,格式参考示例,多级属性用英文逗号隔开,第二个属性及为第一个的属性值的子属性,第三个属性为第二个属性的子属性,以此类推。如需返回此类目对应的子属性,则需同cateid一起进行提交。 |
入参只需要传入param1,返回类目下所有一级属性(PS.大部分属性都是一级属性,车型库属性属性多层级联属性,它的第一层属性跟随其他一级属性返回)
param1:200000219
每次获取属性只能获取一个子属性,示例中获取的是法国下的Make,也就是country(231208804)为FR(61443)的Make的属性有哪些
请求示例:
param1:200000219
param2:231208804=361443
响应示例:
{ "aliexpress_category_redefining_getchildattributesresultbypostcateidandpath_response": { "result": { "attributes": { "aeop_attribute_dto": [ { "attribute_show_type_value": "list_box", "customized_name": false, "customized_pic": false, "features": "{}", "id": 231450617, "input_type": "STRING", "key_attribute": false, "names": "{\"en\":\"Make\"}", "required": false, "sku": false, "spec": 0, "values": { "aeop_attr_value_dto": [ { "id": 100009290, "names": "{\"en\":\"Bmw\",\"zh\":\"宝马\"}", "value_tags": "{}" }, { "id": 100009296, "names": "{\"en\":\"Daewoo\",\"zh\":\"Daewoo\"}", "value_tags": "{}" }, { "id": 100009302, "names": "{\"en\":\"Honda\",\"zh\":\"本田\"}", "value_tags": "{}" }, { "id": 100009304, "names": "{\"en\":\"Hyundai\",\"zh\":\"现代\"}", "value_tags": "{}" }, { "id": 100009308, "names": "{\"en\":\"JEEP\",\"zh\":\"Jeep\"}", "value_tags": "{}" }, { "id": 100009315, "names": "{\"en\":\"Lotus\",\"zh\":\"Lotus\"}", "value_tags": "{}" }, { "id": 100009322, "names": "{\"en\":\"MINI\",\"zh\":\"mini\"}", "value_tags": "{}" }, { "id": 200039563, "names": "{\"en\":\"vw\",\"zh\":\"vw\"}", "value_tags": "{}" }, { "id": 200039599, "names": "{\"en\":\"Rover\",\"zh\":\"罗孚\"}", "value_tags": "{}" }, { "id": 201441710, "names": "{\"en\":\"Geo\",\"zh\":\"吉优\"}", "value_tags": "{}" } ] }, "visible": true } ] }, "success": true }, "request_id": "36a73nnxqa2v" } }
每次获取属性只能获取一个子属性,示例中获取的是法国宝马下的model,也就是Make(231450617)为Bmw(100009290)的Model的属性有哪些
请求示例:
param1:200000219
param2:231208804=361443,231450617=100009290
响应示例:
{ "aliexpress_category_redefining_getchildattributesresultbypostcateidandpath_response": { "result": { "attributes": { "aeop_attribute_dto": [ { "attribute_show_type_value": "list_box", "customized_name": false, "customized_pic": false, "features": "{}", "id": 231539129, "input_type": "STRING", "key_attribute": false, "names": "{\"en\":\"Model\"}", "required": false, "sku": false, "spec": 0, "values": { "aeop_attr_value_dto": [ { "id": 150, "names": "{\"en\":\"1\",\"zh\":\"1\"}", "value_tags": "{}" }, { "id": 152, "names": "{\"en\":\"3\",\"zh\":\"3\"}", "value_tags": "{}" }, { "id": 698, "names": "{\"en\":\"5\",\"zh\":\"5\"}", "value_tags": "{}" }, { "id": 1394, "names": "{\"en\":\"6\",\"zh\":\"6\"}", "value_tags": "{}" }, { "id": 3434, "names": "{\"en\":\"7\",\"zh\":\"7\"}", "value_tags": "{}" }, { "id": 361352, "names": "{\"en\":\"I3\",\"zh\":\"I3\"}", "value_tags": "{}" }, { "id": 100011072, "names": "{\"en\":\"X3\",\"zh\":\"X3\"}", "value_tags": "{}" }, { "id": 100011073, "names": "{\"en\":\"X5\",\"zh\":\"X5\"}", "value_tags": "{}" }, { "id": 100011074, "names": "{\"en\":\"X6\",\"zh\":\"X6\"}", "value_tags": "{}" }, { "id": 200005765, "names": "{\"en\":\"X1\",\"zh\":\"X1\"}", "value_tags": "{}" }, { "id": 200005766, "names": "{\"en\":\"X2\",\"zh\":\"X2\"}", "value_tags": "{}" }, { "id": 200005982, "names": "{\"en\":\"X7\",\"zh\":\"X7\"}", "value_tags": "{}" }, { "id": 200040118, "names": "{\"en\":\"i8\",\"zh\":\"i8\"}", "value_tags": "{}" }, { "id": 200052774, "names": "{\"en\":\"X4\",\"zh\":\"X4\"}", "value_tags": "{}" }, { "id": 591016145, "names": "{\"en\":\"Z4 Coupe\",\"zh\":\"Z4 双门轿跑车\"}", "value_tags": "{}" }, { "id": 1376731613, "names": "{\"en\":\"Z3 Roadster\",\"zh\":\"Z3 敞篷跑车\"}", "value_tags": "{}" }, { "id": 2838053387, "names": "{\"en\":\"2 Coupe\",\"zh\":\"月双门轿跑车\"}", "value_tags": "{}" }, { "id": 2838053420, "names": "{\"en\":\"Z3 Coupe\",\"zh\":\"Z3 双门轿跑车\"}", "value_tags": "{}" }, { "id": 2838241391, "names": "{\"en\":\"2 Active Tourer\",\"zh\":\"月有源旅行车\"}", "value_tags": "{}" }, { "id": 2838241392, "names": "{\"en\":\"2 Gran Tourer\",\"zh\":\"月大旅行车\"}", "value_tags": "{}" }, { "id": 2838241411, "names": "{\"en\":\"4 Gran Coupe\",\"zh\":\"月大跑车\"}", "value_tags": "{}" }, { "id": 2838242383, "names": "{\"en\":\"3 Gran Turismo\",\"zh\":\"月 Gran Turismo\"}", "value_tags": "{}" }, { "id": 2838242393, "names": "{\"en\":\"4 Coupe\",\"zh\":\"月双门轿跑车\"}", "value_tags": "{}" }, { "id": 2838242407, "names": "{\"en\":\"6 Gran Coupe\",\"zh\":\"月大跑车\"}", "value_tags": "{}" }, { "id": 2841033705, "names": "{\"en\":\"3 Touring\",\"zh\":\"月旅游\"}", "value_tags": "{}" }, { "id": 4621143277, "names": "{\"en\":\"6 Gran Turismo\",\"zh\":\"月 Gran Turismo\"}", "value_tags": "{}" }, { "id": 4621185038, "names": "{\"en\":\"I8 Roadster\",\"zh\":\"I8 敞篷跑车\"}", "value_tags": "{}" }, { "id": 6914734375, "names": "{\"en\":\"3 Coupé\",\"zh\":\"月的双门轿跑车\"}", "value_tags": "{}" }, { "id": 6914761268, "names": "{\"en\":\"5 Touring\",\"zh\":\"月旅游\"}", "value_tags": "{}" }, { "id": 6914761278, "names": "{\"en\":\"5 Gran Turismo\",\"zh\":\"月 Gran Turismo\"}", "value_tags": "{}" }, { "id": 6914761430, "names": "{\"en\":\"Z4 Roadster\",\"zh\":\"Z4 敞篷跑车\"}", "value_tags": "{}" }, { "id": 6914767244, "names": "{\"en\":\"1 Coupé\",\"zh\":\"月的双门轿跑车\"}", "value_tags": "{}" }, { "id": 6914767357, "names": "{\"en\":\"3 Compact\",\"zh\":\"月契约\"}", "value_tags": "{}" }, { "id": 6914767726, "names": "{\"en\":\"6 Coupé\",\"zh\":\"月的双门轿跑车\"}", "value_tags": "{}" }, { "id": 6914767931, "names": "{\"en\":\"Z8 Roadster\",\"zh\":\"Z8 敞篷跑车\"}", "value_tags": "{}" }, { "id": 6926114581, "names": "{\"en\":\"1 Décapotable\",\"zh\":\"月 d é capotable\"}", "value_tags": "{}" }, { "id": 6926114614, "names": "{\"en\":\"4 Décapotable\",\"zh\":\"月 d é capotable\"}", "value_tags": "{}" }, { "id": 6926114617, "names": "{\"en\":\"2 Décapotable\",\"zh\":\"月 d é capotable\"}", "value_tags": "{}" }, { "id": 6926114769, "names": "{\"en\":\"6 Décapotable\",\"zh\":\"月 d é capotable\"}", "value_tags": "{}" }, { "id": 6926160572, "names": "{\"en\":\"8 Coupé\",\"zh\":\"月的双门轿跑车\"}", "value_tags": "{}" }, { "id": 6926160574, "names": "{\"en\":\"8 Gran Coupé\",\"zh\":\"军大双门轿跑车\"}", "value_tags": "{}" }, { "id": 6926160576, "names": "{\"en\":\"8 Décapotable\",\"zh\":\"月 d é capotable\"}", "value_tags": "{}" }, { "id": 6926173567, "names": "{\"en\":\"3 Décapotable\",\"zh\":\"月 d é capotable\"}", "value_tags": "{}" } ] }, "visible": true } ] }, "success": true }, "request_id": "lp07nwsdlmcd" } }
每次获取属性只能获取一个子属性,示例中获取的是法国宝马X5下的Year,也就是Model(231539129)为X5(100011073)的Year的属性有哪些
请求示例:param1:200000219
param2:231208804=361443,231450617=100009290,231539129=100011073
响应示例:
{ "aliexpress_category_redefining_getchildattributesresultbypostcateidandpath_response": { "result": { "attributes": { "aeop_attribute_dto": [ { "attribute_show_type_value": "list_box", "customized_name": false, "customized_pic": false, "features": "{}", "id": 231541281, "input_type": "STRING", "key_attribute": false, "names": "{\"en\":\"Year\"}", "required": false, "sku": false, "spec": 0, "values": { "aeop_attr_value_dto": [ { "id": 695, "names": "{\"en\":\"2000\",\"zh\":\"2000\"}", "value_tags": "{}" }, { "id": 100009358, "names": "{\"en\":\"2001\",\"zh\":\"2001\"}", "value_tags": "{}" }, { "id": 100009359, "names": "{\"en\":\"2002\",\"zh\":\"2002\"}", "value_tags": "{}" }, { "id": 100009362, "names": "{\"en\":\"2005\",\"zh\":\"2005\"}", "value_tags": "{}" }, { "id": 100009363, "names": "{\"en\":\"2006\",\"zh\":\"2006\"}", "value_tags": "{}" }, { "id": 100009364, "names": "{\"en\":\"2007\",\"zh\":\"2007\"}", "value_tags": "{}" }, { "id": 100009365, "names": "{\"en\":\"2008\",\"zh\":\"2008\"}", "value_tags": "{}" }, { "id": 100009366, "names": "{\"en\":\"2009\",\"zh\":\"2009\"}", "value_tags": "{}" }, { "id": 100014424, "names": "{\"en\":\"2010\",\"zh\":\"2010\"}", "value_tags": "{}" }, { "id": 100015403, "names": "{\"en\":\"2003\",\"zh\":\"2003\"}", "value_tags": "{}" }, { "id": 100015633, "names": "{\"en\":\"2004\",\"zh\":\"2004\"}", "value_tags": "{}" }, { "id": 200013825, "names": "{\"en\":\"2011\",\"zh\":\"2011\"}", "value_tags": "{}" }, { "id": 200013826, "names": "{\"en\":\"2012\",\"zh\":\"2012\"}", "value_tags": "{}" }, { "id": 200013827, "names": "{\"en\":\"2013\",\"zh\":\"2013\"}", "value_tags": "{}" }, { "id": 200041042, "names": "{\"en\":\"2018\",\"zh\":\"2018\"}", "value_tags": "{}" }, { "id": 200041101, "names": "{\"en\":\"2017\",\"zh\":\"2017\"}", "value_tags": "{}" }, { "id": 200041240, "names": "{\"en\":\"2016\",\"zh\":\"2016\"}", "value_tags": "{}" }, { "id": 200042788, "names": "{\"en\":\"2014\",\"zh\":\"2014\"}", "value_tags": "{}" }, { "id": 200043068, "names": "{\"en\":\"2015\",\"zh\":\"2015\"}", "value_tags": "{}" }, { "id": 200044641, "names": "{\"en\":\"2019\",\"zh\":\"2019\"}", "value_tags": "{}" } ] }, "visible": true } ] }, "success": true }, "request_id": "36adc5fowtmh" } }
每次获取属性只能获取一个子属性,示例中获取的是法国宝马X5 2015 下的Trim,其中Year(231541281)为2015(200043068)的Trim的属性有哪些
请求示例:
param1:200000219
param2:231208804=361443,231450617=100009290,231539129=100011073,231541281=200043068
响应示例:
{ "aliexpress_category_redefining_getchildattributesresultbypostcateidandpath_response": { "result": { "attributes": { "aeop_attribute_dto": [ { "attribute_show_type_value": "list_box", "customized_name": false, "customized_pic": false, "features": "{}", "id": 231541380, "input_type": "STRING", "key_attribute": false, "names": "{\"en\":\"Trim\"}", "required": false, "sku": false, "spec": 0, "values": { "aeop_attr_value_dto": [ { "id": 6914734473, "names": "{\"en\":\"xDrive40e F15, F85\",\"zh\":\"XDrive40e F15,F85\"}", "value_tags": "{}" }, { "id": 6914734750, "names": "{\"en\":\"sDrive 25d F15, F85\",\"zh\":\"SDrive F15 25d,F85\"}", "value_tags": "{}" }, { "id": 6914761461, "names": "{\"en\":\"xDrive30d F15, F85\",\"zh\":\"XDrive30d F15,F85\"}", "value_tags": "{}" }, { "id": 6914767368, "names": "{\"en\":\"xDrive25d F15, F85\",\"zh\":\"XDrive25d F15,F85\"}", "value_tags": "{}" }, { "id": 6915131185, "names": "{\"en\":\"M F15, F85\",\"zh\":\"米 F15,F85\"}", "value_tags": "{}" }, { "id": 6915131292, "names": "{\"en\":\"xDrive50i F15, F85\",\"zh\":\"XDrive50i F15,F85\"}", "value_tags": "{}" }, { "id": 6915131318, "names": "{\"en\":\"xDrive35i F15, F85\",\"zh\":\"XDrive35i F15,F85\"}", "value_tags": "{}" }, { "id": 6915131381, "names": "{\"en\":\"M50d F15, F85\",\"zh\":\"M50d F15,F85\"}", "value_tags": "{}" }, { "id": 6915131527, "names": "{\"en\":\"xDrive40d F15, F85\",\"zh\":\"XDrive40d F15,F85\"}", "value_tags": "{}" } ] }, "visible": true } ] }, "success": true }, "request_id": "36adc5gf6erk" } }
每次获取属性只能获取一个子属性,示例中获取的是法国宝马X5 2015,xDrive40d F15, F85 下的Engine,其中Trim(231541380)为xDrive40d F15, F85(6915131527)的Engine的属性有哪些
请求示例:
param1:200000219
param2:231208804=361443,231450617=100009290,231539129=100011073,231541281=200043068,231541380=6915131527
响应示例:
{ "aliexpress_category_redefining_getchildattributesresultbypostcateidandpath_response": { "result": { "attributes": { "aeop_attribute_dto": [ { "attribute_show_type_value": "list_box", "customized_name": false, "customized_pic": false, "features": "{}", "id": 231566248, "input_type": "STRING", "key_attribute": false, "names": "{\"en\":\"Engine\"}", "required": false, "sku": false, "spec": 0, "values": { "aeop_attr_value_dto": [ { "id": 6914734424, "names": "{\"en\":\"2993 ccm, 230 KW, 313 PS\",\"zh\":\"2993 立方厘米,230 千瓦,313 PS\"}", "value_tags": "{}" } ] }, "visible": true } ] }, "success": true }, "request_id": "36adc5gup0ka" } }
查询类目属性,类目属性中有features属性,AE_FEATURE_car_cascade_property:1
“features”: “{"AE_FEATURE_car_cascade_property":"1"}”,
{ "attribute_show_type_value": "check_box", "customized_name": false, "customized_pic": false, "features": "{\"AE_FEATURE_car_cascade_property\":\"1\"}", "id": 231208804, "input_type": "STRING", "key_attribute": false, "names": "{\"en\":\"Country\",\"zh\":\"国家\"}", "required": false, "sku": false, "spec": 0, "values": { "aeop_attr_value_dto": [ { "id": 361443, "names": "{\"en\":\"France\",\"zh\":\"FR\"}", "value_tags": "{}" }, { "id": 100014896, "names": "{\"en\":\"Germany\",\"zh\":\"DE\"}", "value_tags": "{}" }, { "id": 100015011, "names": "{\"en\":\"Spain\",\"zh\":\"ES\"}", "value_tags": "{}" }, { "id": 200004659, "names": "{\"en\":\"Russia\",\"zh\":\"俄罗斯\"}", "value_tags": "{}" } ] }, "visible": true }
需要把一个车型对应的Country、Make、Model、Year、Trim、Engine的属性名id和属性值id完整地传进来。
例如:法国宝马X5 2015年 xDrive40d F15, F85,2993 ccm, 230 KW车型,
aliexpress.postproduct.redefining.postaeproduct发布入参如下:
(aliexpress.offer.product.post新版发布接口,aeop_ae_product_propertys同理)
请求示例:
{ "aeop_ae_product_propertys": [ { "attr_name": "Brand Name", "attr_name_id": 2, "attr_value": "other", "attr_value_id": 203062806 }, { "attr_name": "Item Type", "attr_name_id": 200000204, "attr_value": "Engine Block\t", "attr_value_id": 200000627 }, { "attr_name": "Contry", "attr_name_id": 231208804, "arrt_value": "France", "attr_value_id": 361443 }, { "attr_name": "Make", "attr_name_id": 231450617, "arrt_value": "Bmw", "attr_value_id": 100009290 }, { "attr_name": "Model", "attr_name_id": 231539129, "arrt_value": "X5", "attr_value_id": 100011073 }, { "attr_name": "Year", "attr_name_id": 231541281, "arrt_value": "2015", "attr_value_id": 200043068 }, { "attr_name": "Trim", "attr_name_id": 231541380, "arrt_value": "xDrive40d F15, F85", "attr_value_id": 6915131527 }, { "attr_name": "Engine", "attr_name_id": 231566248, "arrt_value": "2993 ccm, 230 KW", "attr_value_id": 6914734424 } ], "aeop_ae_product_s_k_us": [ { "aeop_s_k_u_property": [ { "property_value_id": 193, "sku_property_id": 14 } ], "currency_code": "USD", "id": "14:193", "ipm_sku_stock": 11, "sku_price": "100000.00", "sku_stock": true } ], "category_id": 200000219, "currency_code": "USD", "delivery_time": 1, "detail": "<div class=\"detailmodule_html\"><div class=\"detail-desc-decorate-richtext\"><p>\n\taaa\n</p></div></div>\r\n", "freight_template_id": 717989142, "gross_weight": "1.000", "image_u_r_ls": "http://ae01.alicdn.com/kf/Hb9a23b22d33d40fbbdcee5f8b8e0830a3.jpg", "lot_num": 1, "package_height": 1, "package_length": 1, "package_type": false, "package_width": 1, "product_price": "100000.00", "product_unit": 100000015, "promise_template_id": 0, "reduce_strategy": "payment_success_deduct", "subject": "test" }
例如:
法国宝马X5 2015年 xDrive40d F15, F85,2993 ccm, 230 KW车型 和
法国宝马X5 2019年 xDrive30d G05,2993 ccm, 183 KW, 249 PS车型
注意:车型属性中完全相同的部分只需要传一次,例如案例中两个车型,都是法国、宝马、X5,只需要传3个属性对,重部分不用传;如果是不同国家,例如法国宝马X5和美国宝马X5,那么发布时需要传6对属性对。
入参如下:
请求示例
{ "aeop_ae_product_propertys": [ { "attr_name": "Brand Name", "attr_name_id": 2, "attr_value": "other", "attr_value_id": 203062806 }, { "attr_name": "Item Type", "attr_name_id": 200000204, "attr_value": "Engine Block\t", "attr_value_id": 200000627 }, { "attr_name": "Contry", "attr_name_id": 231208804, "arrt_value": "France", "attr_value_id": 361443 }, { "attr_name": "Make", "attr_name_id": 231450617, "arrt_value": "Bmw", "attr_value_id": 100009290 }, { "attr_name": "Model", "attr_name_id": 231539129, "arrt_value": "X5", "attr_value_id": 100011073 }, { "attr_name": "Year", "attr_name_id": 231541281, "arrt_value": "2015", "attr_value_id": 200043068 }, { "attr_name": "Trim", "attr_name_id": 231541380, "arrt_value": "xDrive40d F15, F85", "attr_value_id": 6915131527 }, { "attr_name": "Engine", "attr_name_id": 231566248, "arrt_value": "2993 ccm, 230 KW", "attr_value_id": 6914734424 }, { "attr_name": "Year", "attr_name_id": 231541281, "arrt_value": "2019", "attr_value_id": 200044641 }, { "attr_name": "Trim", "attr_name_id": 231608977, "arrt_value": "xDrive40d F15, F85", "attr_value_id": 6915038485 }, { "attr_name": "Engine", "attr_name_id": 231609148, "arrt_value": "2993 ccm, 183 KW, 249 PS", "attr_value_id": 6914767291 } ], "aeop_ae_product_s_k_us": [ { "aeop_s_k_u_property": [ { "property_value_id": 193, "sku_property_id": 14 } ], "currency_code": "USD", "id": "14:193", "ipm_sku_stock": 11, "sku_price": "100000.00", "sku_stock": true } ], "category_id": 200000219, "currency_code": "USD", "delivery_time": 1, "detail": "<div class=\"detailmodule_html\"><div class=\"detail-desc-decorate-richtext\"><p>\n\taaa\n</p></div></div>\r\n", "freight_template_id": 717989142, "gross_weight": "1.000", "image_u_r_ls": "http://ae01.alicdn.com/kf/Hb9a23b22d33d40fbbdcee5f8b8e0830a3.jpg", "lot_num": 1, "package_height": 1, "package_length": 1, "package_type": false, "package_width": 1, "product_price": "100000.00", "product_unit": 100000015, "promise_template_id": 0, "reduce_strategy": "payment_success_deduct", "subject": "test" }
{ "aliexpress_postproduct_redefining_postaeproduct_response": { "result": { "error_code": -99999, "error_message": "CHK_MULTI_CASCADE_NOT_COMPLETE:Property data is incomplete", "is_success": false }, "request_id": "1079tr1spgmt8" } }
您提交的车型属性不完整,只传了Country属性,其余子属性没有传Make、Model、Year、Trim、Engine
{ "aliexpress_postproduct_redefining_postaeproduct_response": { "result": { "error_code": -99999, "error_message": "For models:CHK_ENUM_PROP_VALUE_NOT_IN_OPTION:Property Value illegal: property value not in Candidate List. property named is Engine[231609148], submitted the property value is null[-123].", "is_success": false }, "request_id": "10stf1anubisv" } }
您提交的车型最后一层属性engine属性名id为231609148对应是id:123是错误的。
{ "aliexpress_postproduct_redefining_postaeproduct_response": { "result": { "error_code": 7040048, "error_message": "Details:040048:you submited car model data is error pname: pid:231609148 vid:", "is_success": false }, "request_id": "3q4jzp35swj5" } }
提交的多个车型中,漏了engine属性名id为231609148的车型。