文档中心 > 常见问题

摩托车车型ISV API

更新时间:2021/10/13 访问次数:1220

一、如何获取车型属性

车型属性跟其他类目属性一样,是挂载在类目下的基本属性之一,目前速卖通摩托车型库为5层级联结构,分别是Country>>Make>>Model>>Year>>submodel,获取到第一个层级之后才可以获取选下一层级,依次到最后一级。
所有类目下挂载的车型库是同一个,因此通过类目接口获取的车型数据是一样的
使用aliexpress.category.redefining.getchildattributesresultbypostcateidandpath( 根据发布类目id、父属性路径(可选)获取子属性信息 )获取类目属性(包含摩托车型属性)
只传param1获取类目的一级属性,
同时传param1和param2获取类目的级联属性,每一次查询只能获取一层属性

名称

示例值

描述

param1

200314148

叶子类目id,只传类目id,则只返回一级属性。二级及之后层级的属性,需要传param2去一一获取

param2

231208804=200004549

类目子属性路径,由该子属性上层的类目属性id和类目属性值id组成,格式参考示例,多级属性用英文逗号隔开,第二个属性及为第一个的属性值的子属性,第三个属性为第二个属性的子属性,以此类推。如需返回此类目对应的子属性,则需同cateid一起进行提交。

以类目id=200314148为例,去获取车型属性,示例参数如下:

1、获取第一层属性Country

入参只需要传入param1,返回类目下所有一级属性(PS.大部分属性都是一级属性,车型库属性属性多层级联属性,它的第一层属性跟随其他一级属性返回)
param1:200314148

2、获取第二层属性Make

每次获取属性只能获取一个子属性,示例中获取的是澳大利亚下的Make,也就是country(231208804)为AU(200004549)的Make的属性有哪些
请求示例:
param1:200314148
param2:231208804=200004549
响应示例:

{
  "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"
  }
}

3、获取第三层属性Model

每次获取属性只能获取一个子属性,示例中获取的是tornado下的model,也就是Make(251576357)为benelli(201487454)的Model的属性有哪些
请求示例:
param1:200314148
param2:231208804=200004549,251576357=201487454
响应示例:

{
  "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"
  }
}

4、获取第四层属性Year

每次获取属性只能获取一个子属性,示例中获取的是benelli tornado下的Year,也就是Model(231539129)为tornado(200201281)的Year的属性有哪些
请求示例:param1:200314148
param2:231208804=200004549,251576357=201487454,251779817=200201281
响应示例:

{
  "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"
  }
}

5、获取第五层属性Submodel

每次获取属性只能获取一个子属性,示例中获取的是benelli tornado 2004 下的Submodel,其中Year(231541281)为2004(100015633)的Trim的属性有哪些
请求示例:
param1:200314148
param2:231208804=200004549,251576357=201487454,251779817=200201281,231541281=100015633
响应示例:

{
  "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"
  }
}

二、哪些类目有车型属性?

查询类目属性,类目属性中有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
}

三、如何发布有车型属性的商品?

1、发布有一个车型属性的商品

需要把一个车型对应的Country、Make、Model、Year、Submodel的属性名id和属性值id完整地传进来。
例如:AU benelli tornado 2004 Tornado 900 Tre (TB)车型,
aliexpress.postproduct.redefining.postaeproduct发布入参如下:
(aliexpress.offer.product.post新版发布接口,aeop_ae_product_propertys同理)
请求示例:

参考汽车的发布部分

2、发布多个车型:

例如:
AU benelli tornado 2004 Tornado 900 Tre (TB)车型 和
AU benelli tornado 2004 Tornado 901 Tre (TB)车型
注意:车型属性中完全相同的部分只需要传一次,例如案例中两个车型,都是澳大利亚、benelli、tornado,只需要传3个属性对,重部分不用传;如果是不同国家,例如tornado和DE tornado,那么发布时需要传6对属性对。
入参如下:
请求示例

参考汽车的发布部分

四、常见错误:

1、属性不完整

{
  "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、Submodel

2、属性值错误

{
  "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 submodel[251771265], submitted the property value is null[-123].",
      "is_success": false
    },
    "request_id": "10stf1anubisv"
  }
}


您提交的车型最后一层属性submodel属性名id为251771265对应是id:123是错误的。

3、多车型商品,属性缺失

{
  "aliexpress_postproduct_redefining_postaeproduct_response": {
    "result": {
      "error_code": 7040048,
      "error_message": "Details:040048:you submited car model data is error pname: pid:251771265 vid:",
      "is_success": false
    },
    "request_id": "3q4jzp35swj5"
  }
}

提交的多个车型中,漏了submodel属性名id为251771265的车型。

FAQ

关于此文档暂时还没有FAQ
返回
顶部