书同文汽配数据API接口服务

获取车架号信息(用于获取车辆销售信息)

Uri:	`/epc/getVinInfo/v3.2`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	vin	是	17位车辆识别码	支持主流在跑乘用车辆品牌

Example:

{
    "code": 100,
    "msg": "/getVinInfo/v3.2 => 请求成功",
    "data": {
        "brand": "本田",
        "factory": "东风本田",
        "series": "艾力绅",
        "model": "艾力绅",
        "year": "2012款",
        "sales": "2012款 2.4L VTi豪华版",
        "price": "29.38万",
        "chassis": "RR7",
        "gen": "艾力绅(第一代,2012-2015)",
        "body": "5门7座MPV",
        "drive": "前置前驱",
        "engine": "K24Z5",
        "displacement": "2.4L",
        "trans": "5挡自动",
        "logo": "https://ctgoe.oss-cn-qingdao.aliyuncs.com/stw/epcbrandlogo/honda.png",
        "img": "https://ctgoe.oss-cn-qingdao.aliyuncs.com/stw/vehicle_img/autohome/1024x0_1_q95_autohomecar__201308081701269343686.jpg",
        "expensive": false,
        "vid": "a11399",
        "ktype": "100",
        "levelid": "xxx"
    }
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
object	data	返回的数据，车辆信息
string	brand	品牌
string	factory	厂牌
string	series	车系
string	model	车型
string	year	年款
string	sales	销售版本
string	price	厂商指导价
string	chassis	底盘号/车型代号
string	gen	车组
string	body	车辆类型
string	drive	驱动形式
string	engine	发动机型号
string	displacement	排量
string	trans	变速箱描述
string	logo	品牌logo图片地址
string	img	车辆图片地址
bool	expensive	该车型是否高价值(针对拆车评估)
string	vid	车型id(非稳定维护字段。如有需求，请另行沟通)
string	ktype	车型id(非稳定维护字段。如有需求，请另行沟通)
string	levelid	车型id(非稳定维护字段。如有需求，请另行沟通)

解析车架号(用于全车件查询)

Uri:	`/epc/parseVin/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	vin	是	17位车辆识别码	支持品牌见附录

Example1:

{
    "code": 100,
    "msg": "/parseVin/v3.1 => 请求成功",
    "data": {
        "brand": "起亚",
        "factory": "东风悦达起亚",
        "series": "K2",
        "model": "K2-两厢",
        "year": "2012",
        "sales": "1.6 自动 Premium",
        "price": "",
        "chassis": "UB",
        "gen": "",
        "body": "轿车",
        "drive": "前置前驱",
        "engine": "G4FC",
        "displacement": "1.6",
        "trans": "自动变速器(AT)",
        "logo": "http://image.ctgoe.com/stw/epcbrandlogo/kia.png",
        "img": "http://image.ctgoe.com/stw/carimg/k2liangxiang_2012.jpg",
        "expensive": false,
        "vid": "",
        "carid": "665c7cd8-94ca-4f6f-ae46-5b30f116e718",
        "epc": "KIA",
        "ctggroupSupport": false,
        "epcgroupSupport": true,
        "option": []
    }
}

Example2:

{
    "code": 100,
    "msg": "/parseVin/v3.1 => 请求成功",
    "data": {
        "brand": "本田",
        "factory": "广汽本田",
        "series": "雅阁",
        "model": "第八代雅阁",
        "year": "2008",
        "sales": "2.0 自动 EX 标准版",
        "price": "",
        "chassis": "CP1",
        "gen": "",
        "body": "轿车",
        "drive": "前置前驱",
        "engine": "R20A3",
        "displacement": "2.0",
        "trans": "自动变速器(AT)",
        "logo": "http://image.ctgoe.com/stw/epcbrandlogo/honda.png",
        "img": "http://image.ctgoe.com/stw/carimg/dibadaiyage_2008.jpg",
        "expensive": false,
        "vid": "",
        "carid": "",
        "epc": "HONDA",
        "ctggroupSupport": true,
        "epcgroupSupport": true,
        "option": [
            {
                "carid": "cdc1931f-84b4-4dee-9747-090ea9949812",
                "ctggroupSupport": true,
                "epcgroupSupport": true,
                "attributeList": [
                    {
                        "attributeKey": "",
                        "attributeName": "等级",
                        "attributeValue": "2.0EX(发动机型号R20A3)",
                        "show": true
                    },
                    {
                        "attributeKey": "",
                        "attributeName": "配置",
                        "attributeValue": "左舵,导航,车载诊断系统,天窗",
                        "show": true
                    }
                ]
            },
            {
                "carid": "9f5dcc1d-aaf7-4241-b6ab-de4db382d4e4",
                "ctggroupSupport": true,
                "epcgroupSupport": true,
                "attributeList": [
                    {
                        "attributeKey": "",
                        "attributeName": "等级",
                        "attributeValue": "2.0EX(发动机型号R20A3)",
                        "show": true
                    },
                    {
                        "attributeKey": "",
                        "attributeName": "配置",
                        "attributeValue": "左舵,车载诊断系统,天窗",
                        "show": true
                    }
                ]
            }
        ]
    }
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
object	data	返回的数据，车辆信息
string	brand	品牌
string	factory	厂牌
string	series	车系
string	model	车型
string	year	年款
string	sales	销售版本
string	price	厂商指导价
string	chassis	底盘号/车型代号
string	gen	车组
string	body	车辆类型
string	drive	驱动形式
string	engine	发动机型号
string	displacement	排量
string	trans	变速箱描述
string	logo	品牌logo图片地址
string	img	车辆图片地址
bool	expensive	该车型是否高价值(针对拆车评估)
string	vid	车型id
string	carid	车辆id(用以支持后续BOM相关查询)
string	epc	车辆所属epc
bool	ctggroupSupport	该车型是否支持以标准分组查询BOM
bool	epcgroupSupport	该车型是否支持以原厂分组查询BOM
array[object]	option	车辆差异化参数选项(当系统无法锁定车辆时)
array[object]	attributeList	属性列表
string	attributeList.attributeKey	属性键名(用于传参)
string	attributeList.attributeName	属性名称
string	attributeList.attributeValue	属性值
bool	attributeList.show	属性是否需要展示于页面

Note:

1.大部分情形下，回参"data.carid"有值即代表该车可查询BOM零件数据，如example1

2.少数情形，例如《本田/讴歌》车架号或其他解析途径，可能发生车架号无法锁定，此时回参"data.option"字段包含了差异化参数，可展示于页面以供用户手动确认选择，如example2

3.回参"data.carid"与"data.option"不会同时有值

4.若"carid"为空，则所查vin或手动选择的车辆尚不支持全车件数据查询

获取carid中原厂车辆信息

Uri:	`/epc/getCaridInfo/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id

Example:

{
    "code": 100,
    "msg": "/vin/info/v3.1 => 请求成功",
    "data": [
        {
            "attributeKey": "",
            "attributeName": "年份",
            "attributeValue": "2008",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "车身形式",
            "attributeValue": "4",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "发布地区",
            "attributeValue": "KH",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "变速箱",
            "attributeValue": "5AT",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "等级",
            "attributeValue": "2.0EX(发动机型号R20A3)",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "发动机",
            "attributeValue": "R20A3",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "底盘",
            "attributeValue": "CP1",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "生产地区",
            "attributeValue": "CN",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "车系",
            "attributeValue": "雅阁",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "厂牌",
            "attributeValue": "广汽本田",
            "show": true
        },
        {
            "attributeKey": "",
            "attributeName": "品牌",
            "attributeValue": "本田",
            "show": true
        }
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，原厂信息列表
string	attributeKey	属性键名(用于传参)
string	attributeName	属性名称
string	attributeValue	属性值
bool	show	属性是否需要展示于页面

获取原厂BOM主组

Uri:	`/epc/getEpcMainGroup/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id

Example:

{
    "code": 100,
    "msg": "/getEpcMainGroup/v3.1 => 请求成功",
    "data": [
        {
            "labelId": "1",
            "categoryId": "1",
            "groupId": "",
            "parentCategoryId": "",
            "des": "发动机",
            "remark": "",
            "img": "http://image.ctgoe.com/stw/empty.png",
            "applicable": true,
            "modelcode": "",
            "model": "",
            "begin": "",
            "end": ""
        },
        {
            "labelId": "2",
            "categoryId": "2",
            "groupId": "",
            "parentCategoryId": "",
            "des": "传动装置",
            "remark": "",
            "img": "http://image.ctgoe.com/stw/empty.png",
            "applicable": true,
            "modelcode": "",
            "model": "",
            "begin": "",
            "end": ""
        },
        ...
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，原厂BOM主组列表
string	labelId	主组id(用于页面显示)
string	categoryId	主组id(用于传参)
string	groupId	分组id
string	parentCategoryId	父级分组id
string	des	主组名称
string	remark	备注
string	img	主组图片地址
bool	applicable	是否适用于当前查询车辆
string	modelcode	车型代码
string	model	车型
string	begin	起始时间
string	end	截止时间

获取原厂BOM分组

Uri:	`/epc/getEpcSubGroup/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id
string	categoryId	是	原厂BOM主组id
string	oe	否	零件编码	用于查询指定oe所在的原厂BOM分组

Example:

{
    "code": 100,
    "msg": "/getEpcSubGroup/v3.1 => 请求成功",
    "data": [
        {
            "labelId": "E-1",
            "categoryId": "E__0100",
            "groupId": "E__0100",
            "parentCategoryId": "1",
            "des": "节流阀体",
            "remark": "",
            "img": "http://image.ctgoe.com/stw/epc/honda/2007/19SYJDB1/E__0100.PNG",
            "applicable": true,
            "modelcode": "",
            "model": "",
            "begin": "",
            "end": ""
        },
        {
            "labelId": "E-2",
            "categoryId": "E__0200",
            "groupId": "E__0200",
            "parentCategoryId": "1",
            "des": "安装管道",
            "remark": "",
            "img": "http://image.ctgoe.com/stw/epc/honda/2007/19SYJDB1/E__0200.PNG",
            "applicable": true,
            "modelcode": "",
            "model": "",
            "begin": "",
            "end": ""
        },
        ...
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，原厂BOM分组列表
string	labelId	分组id(用于页面显示)
string	categoryId	分组id(用于传参)
string	groupId	分组id
string	parentCategoryId	父级分组id
string	des	分组名称
string	remark	备注
string	img	分组图片地址
bool	applicable	是否适用于当前查询车辆
string	modelcode	车型代码
string	model	车型
string	begin	起始时间
string	end	截止时间

获取标准BOM分组

Uri:	`/epc/getCtgGroup/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id

Example:

{
    "code": 100,
    "msg": "/getCtgGroup/v3.1 => 请求成功",
    "data": [
        {
            "labelId": "",
            "categoryId": "101",
            "groupId": "",
            "parentCategoryId": "100",
            "des": "车身部分",
            "remark": "",
            "img": "http://image.ctgoe.com/stw/empty.png",
            "applicable": true,
            "modelcode": "",
            "flevel": 1,
            "ctgnum": "",
            "alias": "",
            "fname_py": "CSBF",
            "alias_py": "",
            "model": "",
            "begin": "",
            "end": ""
        },
        {
            "labelId": "",
            "categoryId": "101-01",
            "groupId": "",
            "parentCategoryId": "101",
            "des": "前保险杠",
            "remark": "",
            "img": "http://image.ctgoe.com/stw/empty.png",
            "applicable": true,
            "modelcode": "",
            "flevel": 2,
            "ctgnum": "2803",
            "alias": "前保",
            "fname_py": "QBXG",
            "alias_py": "QB",
            "model": "",
            "begin": "",
            "end": ""
        },
		...
	]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，标准BOM分组列表
string	labelId	分组id(用于页面显示)
string	categoryId	分组id(用于传参)
string	groupId	分组id
string	parentCategoryId	父级分组id
string	des	分组名称
string	remark	备注
string	img	分组图片地址
bool	applicable	是否适用于当前查询车辆
string	modelcode	车型代码
string	flevel	所在层级
string	ctgnum	标准编码
string	alias	别名/俗名/江湖名
string	fname_py	分组名称各拼音首字母
string	alias_py	别名各拼音首字母
string	model	车型
string	begin	起始时间
string	end	截止时间

获取拆车BOM分组

Uri:	`/epc/getDismantleGroup/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id

Example:

{
    "code": 100,
    "msg": "/getDismantleGroup/v3.1 => 请求成功",
    "data": [
        {
            "id": 12,
            "categoryId": "102",
            "parentCategoryId": "100",
            "des": "车门总成",
            "disnum": "C0002",
            "flevel": "1",
            "ctgnum": "",
            "posi": "",
            "att_col": "",
            "att_met": "",
            "att_le": "",
            "loc_num": ""
        },
        {
            "id": 127,
            "categoryId": "103",
            "parentCategoryId": "100",
            "des": "前嘴总成",
            "disnum": "C0003",
            "flevel": "1",
            "ctgnum": "",
            "posi": "",
            "att_col": "",
            "att_met": "",
            "att_le": "",
            "loc_num": ""
        },
		...
	]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，拆车BOM分组列表
int	id	主键
string	categoryId	分组id
string	parentCategoryId	父级分组id
string	des	分组名称
string	disnum	拆车分类编码
string	flevel	所在层级
string	ctgnum	标准编码
string	posi	方位
string	att_col	颜色
string	att_met	材质
string	att_le	新旧程度
string	loc_num	位置值

获取适用BOM清单

Uri:	`/epc/getBomData/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id
string	categoryType	是	分组类型	可选值："EPC"(原厂分组)/"CTG"(标准分组)
string	categoryId	是	分组id	categoryType=EPC时必选
string	simpleCategoryId	否	精简分组id	仅适用于categoryType=CTG时
string	oe	否	零件编码	仅适用于categoryType=CTG时，长度至少3位
string	partName	否	零件名	仅适用于categoryType=CTG时
string	stwname	否	标准名称	仅适用于categoryType=CTG时
array[string]	posiNum	否	位置节点	仅适用于categoryType=CTG时
array[string]	categoryidList	否	分组id集合	仅适用于categoryType=CTG时
array[string]	ctgnumList	否	标准编码	仅适用于categoryType=CTG时
array[string]	collisionDegreeList	否	碰撞程度	仅适用于categoryType=CTG时可选值: "轻度"/"中度"/"重度"
array[string]	collisionSiteList	否	碰撞部位	仅适用于categoryType=CTG时可选值: "左侧"/"右侧"/"车顶" "前左"/"前中"/"前右" "后左"/"后中"/"后右"
bool	hfreqOnly	否	是否只查询高频的部位	仅适用于categoryType=CTG时
bool	showPartsNameAnyway	否	是否在任何条件下都展示零件名称(即使没有零件编码)	仅适用于categoryType=CTG时，需配合碰撞参数使用

Example1:

{
    "code": 100,
    "msg": "/getBomData/v3.1 => 请求成功",
    "data": [
        {
            "oe": "13030R5AA10",
            "des": "活塞组（OS 0.25）",
            "ctgname": "活塞",
            "stwname": "活塞",
            "amount": "(4)",
            "sign": "1",
            "remark": "",
            "ctgnum": "1004101",
            "partsGroup": [],
            "epc": "HONDA",
            "applicable": true,
            "begin": "",
            "end": "",
            "model": ""
        },
        {
            "oe": "13020R5AA10",
            "des": "活塞",
            "ctgname": "活塞",
            "stwname": "活塞",
            "amount": "004",
            "sign": "1",
            "remark": "",
            "ctgnum": "1004101",
            "partsGroup": [],
            "epc": "HONDA",
            "applicable": true,
            "begin": "",
            "end": "",
            "model": "",
        },
		...
	]
}

Example2:

{
    "code": 100,
    "msg": "/getBomData/v3.1 => 请求成功",
    "data": [
        {
            "oe": "71101SYJH00ZZ",
            "des": "前保险杠正面",
            "ctgname": "前保险杠皮",
            "stwname": "前保险杠皮",
            "amount": "001",
            "sign": "1",
            "remark": "",
            "ctgnum": "2803111",
            "partsGroup": [
                {
                    "labelId": "B-46",
                    "categoryId": "B__4600",
                    "groupId": "B__4600",
                    "parentCategoryId": "5",
                    "des": "前保险杠",
                    "remark": "",
                    "img": "http://image.ctgoe.com/stw/epc/honda/2007/19SYJDB1/B__4600.PNG",
                    "applicable": true,
                    "modelcode": ""
                }
            ],
            "epc": "HONDA",
            "applicable": true,
            "begin": "",
            "end": ""
        },
        {
            "oe": "71109SYJH01",
            "des": "前保险杠下格栅",
            "ctgname": "前保险杠下格栅",
            "stwname": "前保险杠下格栅",
            "amount": "001",
            "sign": "7",
            "remark": "",
            "ctgnum": "2803337",
            "partsGroup": [
                {
                    "labelId": "B-46",
                    "categoryId": "B__4600",
                    "groupId": "B__4600",
                    "parentCategoryId": "5",
                    "des": "前保险杠",
                    "remark": "",
                    "img": "http://image.ctgoe.com/stw/epc/honda/2007/19SYJDB1/B__4600.PNG",
                    "applicable": true,
                    "modelcode": ""
                }
            ],
            "epc": "HONDA",
            "applicable": true,
            "begin": "",
            "end": ""
        },
		...
	]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，BOM清单列表
string	oe	零件编码
string	des	原厂名称
string	ctgname	标准名称
string	stwname	标准名称(用法2)
string	amount	装车用量
string	sign	索引号
string	remark	备注
string	ctgnum	标准编码
array	partsGroup	零件所在分组
-	partsGroup.*	同接口 "获取原厂BOM分组"
string	epc	所属epc
bool	applicable	是否适用于当前查询车辆
string	begin	适用时间区间的起始时间
string	end	适用时间区间的截止时间

Note:

1.当入参categoryType=EPC时，回参"partsGroup"不会有值，如example1

2.当入参categoryType=CTG时，回参"partsGroup"将包含零件所在该车辆原厂分组的信息，如example2

获取原厂分组图中热点坐标

Uri:	`/epc/getHotspot/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id
string	categoryId	是	原厂分组id

Example:

{
    "code": 100,
    "msg": "/getHotspot/v3.1 => 请求成功",
    "data": [
        {
            "x": "214",
            "y": "158",
            "width": "10",
            "height": "12",
            "sign": "1"
        },
        {
            "x": "392",
            "y": "15",
            "width": "17",
            "height": "12",
            "sign": "10"
        },
		...
	]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，坐标列表
string	x	图中索引号矩形范围左上角x轴坐标
string	y	图中索引号矩形范围左上角y轴坐标
string	width	图中索引号矩形范围的宽度
string	height	图中索引号矩形范围的高度
string	sign	索引号

Note:

获取OE查询所支持的品牌列表

Uri:	`/epc/getOeBrandList/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
无参

Example:

{
    "code": 100,
    "msg": "/getOeBrandList/v3.1 => 请求成功",
    "data": [
        {
            "epc": "ALFAROMEO",
            "brand": "阿尔法罗密欧",
            "firstIndex": "A",
            "logo": "http://image.ctgoe.com/stw/epcbrandlogo/阿尔法罗密欧.png"
        },
        {
            "epc": "ASTONMARTIN",
            "brand": "阿斯顿马丁",
            "firstIndex": "A",
            "logo": "http://image.ctgoe.com/stw/epcbrandlogo/阿斯顿马丁.png"
        },
        {
            "epc": "VOLKSWAGEN",
            "brand": "奥迪",
            "firstIndex": "A",
            "logo": "http://image.ctgoe.com/stw/epcbrandlogo/audi.png"
        },
		...
	]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，品牌列表
string	epc	所属epc
string	brand	品牌名称
string	firstIndex	品牌名称拼音首字母
string	logo	品牌logo图片地址

OE号查询(单条)

Uri:	`/epc/searchOe/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	oe	是	零件编码	支持模糊，长度至少5位
string	epc	否	所属epc
int	pageNum	否	页码	默认第一页
int	pageSize	否	每页条数	默认20条

Example:

{
    "code": 100,
    "msg": "/searchOe/v3.1 => 请求成功",
    "data": [
        {
            "oe": "16400R5GH01",
            "brand": "本田",
            "factory": "东风本田",
            "epc": "HONDA",
            "des": "电控节气门总成    ",
            "ctgname": "节气门总成",
            "stwname": "节气门总成",
            "ctgnum": "1107200",
            "price": "4224.32",
            "priceVersion": "202010",
            "remark": "",
            "partsGroup": [
                {
                    "sign": "1",
                    "labelId": "E__0100",
                    "categoryId": "E__0100",
                    "groupId": "E__0100",
                    "parentCategoryId": "1",
                    "des": "电控节气门总成    ",
                    "remark": "",
                    "img": "http://image.ctgoe.com/stw/epc/honda/2007/19SYJDB1/E__0100.PNG",
                    "applicable": true,
                    "modelcode": "19SYJDB1",
                    "model": "",
                    "begin": "",
                    "end": ""
                },
                {
                    "sign": "1",
                    "labelId": "E__0101",
                    "categoryId": "E__0101",
                    "groupId": "E__0101",
                    "parentCategoryId": "1",
                    "des": "电控节气门总成    ",
                    "remark": "",
                    "img": "http://image.ctgoe.com/stw/epc/honda/2007/19T0TCB1/E__0101.PNG",
                    "applicable": true,
                    "modelcode": "19T0TCB1",
                    "model": "",
                    "begin": "",
                    "end": ""
                }
            ]
        },
        ...
	]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，OE列表
string	oe	零件编码
string	brand	品牌名称
string	factory	厂牌名称
string	epc	所属epc
string	des	原厂名称
string	ctgname	标准名称
string	stwname	标准名称(用法2)
string	ctgnum	标准编码
string	price	4S店含税用户价
string	priceVersion	价格时间版本
string	remark	备注
array[object]	partsGroup	零件所在分组
string	partsGroup.sign	零件在分组中的索引号
-	partsGroup.*	同接口 "获取原厂BOM分组"

OE号查询(批量)

Uri:	`/epc/searchOes/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
array[string]	oe	是	零件编码	支持模糊，长度至少8位
string	epc	否	所属epc

Example:

{
    "code": 100,
    "msg": "/searchOes/v3.1 => 请求成功",
    "data": [
        {
            "oe": "16400R5GH01",
            "brand": "本田",
            "factory": "东风本田",
            "epc": "HONDA",
            "des": "电控节气门总成    ",
            "ctgname": "节气门总成",
            "stwname": "节气门总成",
            "ctgnum": "1107200",
            "price": "4224.32",
            "priceVersion": "202010",
            "remark": "",
            "partsGroup": [
                {
                    "sign": "1",
                    "labelId": "E__0100",
                    "categoryId": "E__0100",
                    "groupId": "E__0100",
                    "parentCategoryId": "1",
                    "des": "电控节气门总成    ",
                    "remark": "",
                    "img": "http://image.ctgoe.com/stw/epc/honda/2007/19SYJDB1/E__0100.PNG",
                    "applicable": true,
                    "modelcode": "19SYJDB1",
                    "model": "",
                    "begin": "",
                    "end": ""
                },
                {
                    "sign": "1",
                    "labelId": "E__0101",
                    "categoryId": "E__0101",
                    "groupId": "E__0101",
                    "parentCategoryId": "1",
                    "des": "电控节气门总成    ",
                    "remark": "",
                    "img": "http://image.ctgoe.com/stw/epc/honda/2007/19T0TCB1/E__0101.PNG",
                    "applicable": true,
                    "modelcode": "19T0TCB1"，
                    "model": "",
                    "begin": "",
                    "end": ""
                }
            ]
        },
        ...
	]
}

Remark:

返回类型	名称	含义
-	-	同接口 "OE号查询(单条)"

获取OE的适用车型(基本字段)

Uri:	`/epc/getOeApply/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
array[string]	oe	是	零件编码	仅支持同一epc下的零件编码
string	epc	是	所属epc

Example:

{
    "code": 100,
    "msg": "/getOeApply/v3.1 => 请求成功",
    "data": [
        {
            "oe": "16400R5GH01",
            "chassisList": [
                "TF3",
                "TF4",
                "RM2",
                "FB3",
                "RR7",
                "RM1",
                "FB2",
                "RM4",
                "RM3",
                "FB6",
                "TF1"
            ],
            "seriesList": [
                "思域",
                "艾力绅",
                "CR-V",
                "歌诗图"
            ],
            "detailList": [
                {
                    "brand": "本田",
                    "factory": "东风本田",
                    "series": "CR-V",
                    "year": "2012",
                    "chassis": "RM2"
                },
                {
                    "brand": "本田",
                    "factory": "东风本田",
                    "series": "思域",
                    "year": "2013",
                    "chassis": "FB2"
                },
                {
                    "brand": "本田",
                    "factory": "广汽本田",
                    "series": "歌诗图",
                    "year": "2011",
                    "chassis": "TF1"
                },
                {
                    "brand": "本田",
                    "factory": "东风本田",
                    "series": "艾力绅",
                    "year": "2013",
                    "chassis": "RR7"
                }
            ]
        }
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，适用车型列表
string	oe	零件编码
array[string]	chassisList	适用底盘号/车型代码列表
array[string]	seriesList	适用车系列表
array[object]	detailList	适用车型明细列表
string	detailList.brand	品牌
string	detailList.factory	厂牌
string	detailList.series	车系
string	detailList.year	年份
string	detailList.chassis	底盘号/车型代码

获取OE的适用车型(原厂字段)

Uri:	`/epc/getOeApplyModel/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	oe	是	零件编码
string	epc	是	所属epc
string	limit	否	不需要对结果条数做限制时，传参，值为"0"	不传默认会做限制

Example:

{
    "code": 100,
    "msg": "/getOeApplyModel/v3.1 => 请求成功",
    "data": {
        "attribute": [
            {
                "k": "epc",
                "n": "epc",
                "s": false
            },
            {
                "k": "epc_brand",
                "n": "品牌",
                "s": true
            },
            {
                "k": "epc_factory",
                "n": "厂牌",
                "s": true
            },
            {
                "k": "epc_series",
                "n": "车系",
                "s": true
            },
            {
                "k": "epc_body",
                "n": "车身形式",
                "s": true
            },
            {
                "k": "epc_year",
                "n": "年份",
                "s": true
            }
        ],
        "value": [
            [
                "HONDA",
                "本田",
                "东风本田",
                "思域",
                "4",
                "2014"
            ],
            [
                "HONDA",
                "本田",
                "东风本田",
                "思域",
                "4",
                "2015"
            ]
        ]
    }
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
object	data	返回的数据
array[object]	attribute	属性信息定义
string	attribute[index].k	属性键名(用于传参)
string	attribute[index].n	属性名称
bool	attribute[index].s	属性是否需要展示于页面
array[array[string]]	value	value[index]为每一条记录；value[index][index]为每一条记录中的值，按照attribute顺序排列

获取OE价格

Uri:	`/epc/getOePrice/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
array[string]	oe	是	零件编码	仅支持同一epc下的零件编码
string	epc	是	所属epc
string	brand	否	品牌
string	factory	否	厂牌

Example:

{
    "code": 100,
    "msg": "/getOePrice/v3.1 => 请求成功",
    "data": [
        {
            "oe": "16400R5GH01",
            "brand": "本田",
            "factory": "东风本田",
            "epc": "HONDA",
            "des": "",
            "ctgname": "",
            "ctgnum": "",
            "price": "4224.32",
            "priceVersion": "202010",
            "remark": "",
            "partsGroup": []
        },
        {
            "oe": "16400R5GH01",
            "brand": "本田",
            "factory": "广汽本田",
            "epc": "HONDA",
            "des": "",
            "ctgname": "",
            "ctgnum": "",
            "price": "4124",
            "priceVersion": "202005",
            "remark": "",
            "partsGroup": []
        }
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，OE价格列表
-	data[index].*	同接口 "OE号查询"

获取OE的替换编码

Uri:	`/epc/searchReplaceOe/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
array[string]	oe	是	零件编码	仅支持同一epc下的零件编码
string	epc	是	所属epc

Example:

{
    "code": 100,
    "msg": "/searchReplaceOe/v3.1 => 请求成功",
    "data": [
        {
            "oe": "01464SNVH01",
            "replaceList": [
                {
                    "oe": "01464SNVH00",
                    "sequence": 1,
                    "type": 2,
                    "source": 0
                },
                {
                    "oe": "01464SNVH02",
                    "sequence": 3,
                    "type": 2,
                    "source": 0
                },
                {
                    "oe": "01464SNVH03",
                    "sequence": 4,
                    "type": 2,
                    "source": 0
                },
                {
                    "oe": "01464SNVH05",
                    "sequence": 5,
                    "type": 2,
                    "source": 0
                }
            ]
        }
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，替换OE列表
string	oe	零件编码
array[object]	replaceList	替换OE列表
string	replaceList.oe	替换OE号
int	replaceList.sequence	替换顺序
int	replaceList.type	替换类型(1:旧换新/2:新旧互换/3:新换旧)
int	replaceList.source	数据源(1:epc/0:非官方/其他来源)

获取OE的实物图

Uri:	`/epc/getOeImage/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
array[string]	oe	是	零件编码	仅支持同一epc下的零件编码
string	epc	是	所属epc	目前仅支持"VOLKSWAGEN*"/"PORSCHE"

Example:

{
    "code": 100,
    "msg": "/getOeImage/v3.1 => 请求成功",
    "data": [
        {
            "oe": "000012279",
            "img": [
                "http://image.ctgoe.com/stw/epc/volkswagen/img/000012279.jpg"
            ]
        },
        {
            "oe": "000051446L",
            "img": [
                "http://image.ctgoe.com/stw/epc/volkswagen/img/051446-0004_1.png",
                "http://image.ctgoe.com/stw/epc/volkswagen/img/000051446L____0002.jpg"
            ]
        }
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[object]	data	返回的数据，替换OE列表
string	data[index].oe	零件编码
array[string]	data[index].img	实物图图片地址

根据原厂车型获取carid

Uri:	`/epc/getCaridByModel/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	{{attributeKey}}	是	属性键名	动态，值为对应的attributeValue

Example:

{
    "code": 100,
    "msg": "/getCaridByModel/v3.1 => 请求成功",
    "data": {
        "brand": "",
        "factory": "",
        "series": "",
        "groups": "",
        "model": "",
        "sales": "",
        "year": "",
        "chassis": "",
        "body": "",
        "engine": "",
        "trans": "",
        "transnum": "",
        "displacement": "",
        "drive": "",
        "logo": "",
        "img": "http://image.ctgoe.com/stw/empty.png",
        "carid": "3cd4d34f-8e42-4cbf-9d87-fb06d2342d6f",
        "ctggroupSupport": true,
        "epcgroupSupport": true,
        "expensive": false,
        "option": [],
        "epc": "HONDA"
    }
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
object	data	返回的数据，carid信息
-	data.*	同接口 "解析车架号"

原厂车型点选(用于全车件查询)

Uri:	`/epc/getEpcModel/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	currentCondition	否	当前所选择的条件名称	值为对应步骤的"nextCondition"
string	{{nextCondition}}	否	当前所选择的条件名称	动态，值为对应步骤的"value"

Example1:

{
    "code": 100,
    "msg": "/getEpcModel/v3.1 => 请求成功",
    "data": {
        "nextCondition": "brand",
        "nextConditionDes": "品牌",
        "valueList": [],
        "initialList": [
            {
                "brand": "奥迪",
                "epcVersion": "202004",
                "firstIndex": "A",
                "logo": "http://image.ctgoe.com/stw/epcbrandlogo/audi.png"
            },
            {
                "brand": "阿尔法罗密欧",
                "epcVersion": "",
                "firstIndex": "A",
                "logo": "http://image.ctgoe.com/stw/epcbrandlogo/阿尔法罗密欧.png"
            },
            {
                "brand": "阿斯顿马丁",
                "epcVersion": "",
                "firstIndex": "A",
                "logo": "http://image.ctgoe.com/stw/epcbrandlogo/阿斯顿马丁.png"
            },
			...
        ],
        "vinInfo": ""
    }
}

Example2:

{
    "code": 100,
    "msg": "/getEpcModel/v3.1 => 请求成功",
    "data": {
        "nextCondition": "CMODNAMEPC",
        "nextConditionDes": "车系",
        "valueList": [
            {
                "value": "CR-V",
                "valueDes": "CR-V"
            },
            {
                "value": "CR-V HYBRID",
                "valueDes": "CR-V混动"
            },
            {
                "value": "CR-Z",
                "valueDes": "CR-Z"
            },
			...
        ],
        "initialList": [],
        "vinInfo": ""
    }
}

Example3:

{
    "code": 100,
    "msg": "/getEpcModel/v3.1 => 请求成功",
    "data": {
        "nextCondition": "",
        "nextConditionDes": "",
        "valueList": [],
        "initialList": [],
        "vinInfo": {
            "brand": "",
            "factory": "东风本田",
            "series": "",
            "groups": "",
            "model": "",
            "sales": "",
            "year": "",
            "chassis": "",
            "body": "",
            "engine": "",
            "trans": "",
            "transnum": "",
            "displacement": "",
            "drive": "",
            "logo": "",
            "img": "http://image.ctgoe.com/stw/empty.png",
            "carid": "64c77fcb-2e86-4b34-9874-3bee8a1c665b",
            "ctggroupSupport": true,
            "epcgroupSupport": true,
            "expensive": false,
            "option": [],
            "epc": "HONDA"
        }
    }
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
object	data	返回的数据，待选车辆信息
string	nextCondition	下一步的条件名称(用于传参)
string	nextConditionDes	下一步的条件名称(用于界面显示)
array[object]	valueList	下一步条件的可选列表
string	valueList[index].value	可选值(用于传参)
string	valueList[index].valueDes	可选值(用于界面显示)
array[object]	initialList	初始化列表数据(仅在第一步无参请求时有值)
string	initialList[index].brand	可选品牌
string	initialList[index].epcVersion	可选品牌的epc时间版本
string	initialList[index].firstIndex	可选品牌的拼音首字母
string	initialList[index].logo	可选品牌的logo图片地址
object	vinInfo	同接口 "解析车架号"，仅在最后一步完成时有值

Note:

1.第一步初始化时，无需入参(body不放任何数据，包括空对象)，展示数据存于回参"initialList"中，如example1

2.最后一步(即所有可选择条件已选择完毕)时，回参"vinInfo"有值，其中包含了"carid"，以支持后续BOM查询，如example3

3.其他情况下，回参"valueList"有值，包含了当前步骤可选的车型条件列表，如example2

销售车型点选(用于全车件查询)

敬请期待

搜索车型下配件名称

Uri:	`/epc/searchPartName/v3.1`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
string	carid	是	车辆id
string	keyword	是	关键词	支持OE号、配件名称/别名关键词、配件名称/别名拼音首字母检索

Example:

{
    "code": 100,
    "msg": "/searchPartName/v3.1 => 请求成功",
    "data": [
        "前大灯(左)",
        "前大灯清洗提升缸",
        "前大灯清洗泵扁触头外壳",
        "前大灯清洗液罐滤网",
        "前大灯清洗装置软管",
        "前大灯灯泡",
        "前大灯调节电机",
    ]
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
array[string]	data	配件名称列表

用户反馈

Uri:	`/ms/feedback/v1.0`
Method:	`post`
Content-type:	`application/json`
Data-type:	`json`
Params:

参数类型	字段名	是否必选	含义	备注
int	type	是	反馈类型	1数据错误 2操作不便 3其他问题
string	des	是	反馈内容
string	img	否	图片base64编码	不带图片头（data:image/jpg;base64,）

Example:

{
    "code": 100,
    "msg": "/feedback/v1.0 => 请求成功",
    "data": "操作成功"
}

Remark:

返回类型	名称	含义
int	code	见附录
string	msg	返回的消息
string	data	操作结果

附录

1.baseurl：https://api.stwoe.cn

2.请求接口时，需在请求头中传入token令牌；token具有时效性，失效时需重新登录获取

3.接口返回的json数据格式：

{
	"code": 100,
	"msg":  "xxx",
	"data": object
}

code:int，状态码；

msg:string，提示信息；

data:object，返回的数据；

code状态码含义如下：

code状态码	含义
100	请求成功
101	请求失败
102	请求异常
103	暂无数据
104	令牌为空
105	令牌错误
106	令牌过期
107	系统过载
108	参数错误
109	服务暂不可用
110	非法请求
120	被禁用的ip
121	被禁用的帐号
122	无权限
123	查询次数不足
124	帐号权限未开通或已到期
125	帐号余额不足
404	资源不存在

4.当前epc全车件数据支持品牌如下：

epc品牌	epc版本	可锁vin
日产/启辰	202005	✔
英菲尼迪	201902	✔
本田/讴歌/思铭	202303	✔
丰田/雷克萨斯	202202	✔
马自达	202107	✔
三菱	202202	✔
斯巴鲁	202109	✔
铃木	201905	✔
别克/雪佛兰/凯迪拉克(上汽通用)	201804
Jeep/道奇/克莱斯勒/阿尔法罗密欧/菲亚特/RAM公羊	202004	✔
福特	202009	✔
特斯拉	201902
奔驰/smart/迈巴赫	201811	✔
宝马/MINI/之诺/劳斯莱斯	202001	✔
大众/奥迪/斯柯达/西雅特/捷达	202102	✔
保时捷	202007	✔
现代	202109	✔
起亚	202109	✔
标致/雪铁龙/DS	201903
路虎	201412	✔
沃尔沃	201410
阿斯顿马丁	201904
宾利	202106
荣威/名爵	202201	✔
江淮	201906
海马	201806
长城/哈弗	201906
五菱/宝骏	201508
五十铃	201803	✔
吉利	201806

更新日志

日期	维护内容
2023.03.15	底层本田epc数据更新至2023年3月版本
2022.08.11	新增宾利epc数据，版本21年6月
2022.07.30	性能优化
2022.06.08	1.新增特斯拉epc数据，版本19年2月(不支持oe锁定) 2.新增吉利epc数据，版本18年6月(不支持oe锁定) 3.新增迈巴赫epc数据，版本18年11月 4.修复全车件vin查询的错误问题
2022.06.02	1.新增阿斯顿马丁epc数据，版本19年4月(不支持oe锁定) 2.优化和修复已知错误
2022.05.28	修复已知错误
2022.05.27	1.底层现代/起亚epc数据更新至2021年9月版本 2.细节优化
2022.05.18	1.优化vin销售信息解析处理逻辑，提高解析成功率 2.细节优化
2022.04.30	1.新增思铭、RAM公羊、铃木、五十铃品牌epc数据 2.新增"获取车架号信息"v3.2版本，优化车架号解析逻辑 3.bug修复和细节优化
2022.04.16	1.底层荣威epc数据更新至2022年1月版本 2.bug修复
2022.03.28	底层三菱epc数据更新至2022年2月版本
2022.03.18	底层斯巴鲁epc数据更新至2021年9月版本
2022.03.12	底层丰田epc数据更新至2022年2月版本
2022.02.26	底层马自达epc数据更新至2021年7月版本
2022.02.22	底层本田epc数据更新至2022年2月版本
2022.02.15	系统优化
2022.01.05	修复oe搜索错误和慢查询问题
2022.01.03	优化bom缓存架构，提升稳定性
2021.12.02	1.修复大众保时捷的过滤错误 2.修复配件缓存创建的错误 3.新增阿尔法罗密欧、菲亚特品牌epc数据
2021.12.02	1.修复大众保时捷的过滤错误
2021.12.02	1.优化oe搜索结果的数据结构
2021.12.01	1.后台优化
2021.11.06	1.若干错误修复
2021.10.31	1.新增oe实物图查询接口
2021.10.15	1.新增起亚全车件数据查询 2.新增车架号车辆信息查询接口
2021.09.02	新版本发布 (1)部分品牌更新 (2)架构优化 (3)支持查询车辆下按关键词搜索配件
2020.01.02	1.接口http协议升级为https
2019.12.31	1.获取EPC图接口新增参数 2.优化标准分类的查询
2019.11.20	1.新增支付相关接口 2.新增车型数据查询(原厂)接口 3.优化调用
2019.08.31	1.发布3.0版本，优化部分接口的调用和传参 2.新增数据
2019.04.21	1.修复部分数据bug 2.新增标致数据 3.'获取适用BOM数据'接口进行了调整，详情见该接口备注
2019.03.25	1.修复部分数据bug 2.新增奔驰、马自达(含4厂牌)数据
2019.02.16	1.修复部分数据bug 2.新增oe品牌查询接口 3.oe查询接口，新增可选参数"epc" 4.oe查询接口，新增支持对多组oe查询 5.新增荣威、名爵、吉利、江淮、海马、长城、哈佛、五菱、宝骏数据
2019.01.17	修复部分数据bug
2019.01.12	1.修复部分数据bug 2.新增斯巴鲁、大众、奥迪、斯柯达、西雅特、北京现代数据
2019.01.02	修复部分数据bug
2018.12.28	1.接口4获取BOM分类数据，部分返回字段变更 2.新增对拆车分类(DISMANTLE)的查询
2018.12.23	业务请求新增身份验证机制
2018.12.07	更新api文档