第三方API文档

第三方API文档整理

创蓝

1. 车辆违章记录查询

https://www.253.com/#/data/product_main/172

1.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	api.253.com/open/kdwl/vehicle_violation

1.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	是否必填	类型	说明
appId	是	String	请在api.253.com登录后获取
appKey	是	String	请在api.253.com登录后获取
carno	是	String	车牌号
cartype	是	String？	车辆类型01，大型汽车；02，小型汽车；03，使馆汽车；04，领馆汽车；05，境外汽车；06，外籍汽车；07，两、三轮摩托车；08，轻便摩托车；09，使馆摩托车；10，领馆摩托车；11，境外摩托车；12，外籍摩托车；13，农用摩托车；14，拖拉机；15，挂车；16，教练汽车；17，教练摩托车；18，试验汽车；19，试验摩托车；20，临时入境汽车；21，临时入境摩托车；22，临时行驶车；23，警用汽车；24，警用摩托；25，原农机号牌；51，新能源-大型汽车；52，新能源-小型汽车
frameno	是	String	车架号,支持后6位查询，或全位查询
engineno	是	String	发动机号,支持后6位查询,或全位查询

1.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
code	int	data内参数：状态码，200为成功，其它为失败
msg	string	data内参数：状态码对应的说明描述
data	object	data内参数：查询结果详细信息
+order_no	string	订单号
+car_no	string	车牌号
+vio_total	string	违章条数
+find_total	string	违章罚款合计
+score_total	string	违章积分合计
+details	array	违章详情；没有违章时为空数组
++vio_time	string	违章时间
++vio_address	string	违章地址
++vio_action	string	违章行为
++vio_fine	string	违章罚款
++vio_score	string	违章记分
++vio_city_name	string	违章所在城市名称
++vio_city	string	违章所在城市代码
++vio_code	string	违法代码
++col_organ	string	采集机构
++decision_num	string	决定书编号
++monitor_num	string	监控编号
++handle_sign	string	处理标记，返回值：1：未处理 未缴费 2：已处理 未缴费 3：已处理 已缴费 为空或不存在值时，默认为：未处理 未缴费。
++handle_num	string	处理编号 在线处理时，传该编号。
++online_handle	string	在线处理，返回值： 1：可以处理；2：不支持处理 为空或不存在结果时，默认为：不支持处理。

---

---

驾驶证信息核查

https://open.253.com/#/data/product_main/95

1. 驾驶证信息核查

1.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	https://api.253.com/open/dianhuabq/driver_license

1.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	类型	是否必填	说明
appId	String	是	请在api.253.com登录后获取
appKey	String	是	请在api.253.com登录后获取
driversLicenseNo	String	是	驾驶证证件号

1.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
code	String	data内参数：返回码
message	string	data内参数：返回码描述
result	string	data内参数：返回数据信息
res	string	result内参数：状态码
driversLicenseNo	object	result内参数：驾驶证证件号
models	string	result内参数：准驾车型 A1 大型客车、A2 牵引车、A3 城市公交车 B1 中型客车、B2 大型货车 C1 小型汽车、C2 小型自动挡汽车、C3 三轮汽车、C4 低速载货汽车 D 三轮摩托车、E 二轮摩托车、F 轻便摩托车 M 轮式自行机械车、N 无轨电车、P 有轨电车
scoring	Object	result内参数：累计扣分
state	string	result内参数：驾驶证状态
startGetLicensingTime	string	result内参数：初次领证时间
endGetLicensingTime	string	result内参数：驾驶证有效时间至
fileNo	String	result内参数：档案编号

2. 驾驶证验证及计分查询

2.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	https://api.253.com/open/kdwl/driver_score

2.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	类型	是否必填	说明
appId	String	是	请在api.253.com登录后获取
appKey	String	是	请在api.253.com登录后获取
city	String	否	省市。支持范围： 北京,天津,上海,重庆,辽宁,吉林,黑龙江, 河北,山西,陕西,山东,安徽,河南,湖北,湖南,江西,福建,云南,海南,四川,贵州,广东, 甘肃,青海,西藏,新疆,广西,内蒙古,宁夏,湖州,嘉兴,杭州,绍兴,宁波,舟山,金华,衢州,丽水,台州, 温州,徐州,连云港,宿迁,盐城,淮安,扬州,泰州,南通,镇江,南京,常州,无锡,苏州
licenseNo	String	是	驾驶证号码
fileNo	String	是	档案编号

2.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
code	String	data内参数：返回码
message	string	data内参数：返回码描述
result	string	data内参数：返回数据信息
score	string	result内参数：扣分总数。查询失败时，此字段不存在

3. 驾驶证信息查询

3.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	https://api.253.com/open/jszhy/jszxxcx

3.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	类型	是否必填	说明
appId	String	是	请在api.253.com登录后获取
appKey	String	是	请在api.253.com登录后获取
idCard	String	是	驾驶证号

3.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
mvTrackId	String	交易流水
guid	string	会话号
detail	string	服务详情
RESULT	string	返回状态码
MESSAGE	string	状态详情
resultCode	string	返回状态码
resultMsg	string	详细信息
idCard	string	驾驶证号
quasiDrivingType	string	准驾车型
scoring	string	累计计分
driverStatus	string	驾驶证状态
name	string	姓名
firstIssueDate	string	初次领证日期
termoFvalidity	string	有效期至
fileNumber	string	档案编号
trafficpolice	string	状态码描述
resultMsg	string	签发机关
startDate	string	有效期始

4. 驾驶证基本信息核验

4.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	api.253.com/open/jszjf/drivingliver

4.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	类型	是否必填	说明
appId	String	是	请在api.253.com登录后获取
appKey	String	是	请在api.253.com登录后获取
name	String	是	姓名
idCard	String	是	身份证号
firstIssueDate	String	是	初次领证日期 ( yyyy-MM-dd)
quasiDrivingType	String	是	准驾车型

4.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
resultCode	String	状态码（1001：验证一致；1002：验证不一致；2001：无数据，3002：参数错误；9999：服务异常）
resultMsg	string	状态码描述

---

---

5. 车辆行驶证核查

https://www.253.com/#/data/product_main/174

5.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	https://api.253.com/open/xszhy/xszdxhy

5.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	类型	是否必填	说明
appId	String	是	请在api.253.com登录后获取
appKey	String	是	请在api.253.com登录后获取
plateNumber	String	是	车架号
plateType	String	是	车牌号
brandName	String	是	号牌种类，车型 01，大型汽车；02，小型汽车；03，使馆汽车； 04，领馆汽车；05，境外汽车；06，外籍汽车； 07，两、三轮摩托车；08，轻便摩托车；09，使馆摩托车； 10，领馆摩托车；11，境外摩托车；12，外籍摩托车； 13，农用摩托车；14，拖拉机；15，挂车； 16，教练汽车；17，教练摩托车；20，临时入境汽车； 21，临时入境摩托车；22，临时行驶车；23，警用汽车；24，警用摩托；51，新能源大型车；52，新能源小型车
bodyColor	String	否	车身颜色
useType	String	否	使用性质
vehicleModelc	String	否	车牌型号
vehicleType	String	否	车辆类型
engineNumber	String	否	发动机号
engineModel	String	否	发动机型号
vin	String	否	车架号
firstIssueDate	String	否	初次登记日期
validityDayEnd	String	否	校验有效日期
owner	String	否	机动车所有人
vehicleStatus	String	否	车辆状态
passengers	String	否	核定载客数
retirementDate	String	否	强制报废期止
fuelType	String	否	燃料种类, A 汽油 B 柴油 C 电驱动（电能驱动汽车） D 混合油 E 天然气 F 液化石油气 L 甲醇 M 乙醇 N 太阳能 O 混合动力 Y 无（仅限全挂车等无动力的） Z 其他 P 插电式混合动力 Q 氢气
cc	String	否	排量
ppsDate	String	否	出厂日期
maxJourney	String	否	最大功率
shaft	String	否	轴数
wheelBase	String	否	轴距
frontTread	String	否	前轮距
rearTread	String	否	后轮距
crossWeight	String	否	总质量
curbWeight	String	否	整备质量
loadWeight	String	否	核定载质量
brandName	String	否	品牌名称

5.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
guid	String	会话号
mvTrackId	string	交易流水号
RESULT	string	状态码
MESSAGE	string	状态描述信息，结果说明
detail	object	服务详情
brandName	string	品牌名称
bodyColor	string	车身颜色
useType	string	使用性质
vehicleModelc	string	车牌型号
vehicleType	string	车辆类型
engineNumber	String	发动机号
engineModel	string	发动机型号
vin	string	车架号
firstIssueDate	string	初次登记日期
validityDayEnd	string	检验有效期止
owner	string	机动车所有人
vehicleStatus	string	车辆状态
passengers	string	核定载客数
retirementDate	string	强制报废期止
fuelType	string	燃料种类
cc	string	排量
ppsDate	string	出厂日期
maxJourney	string	最大功率（KW）
shaft	string	轴数
wheelBase	string	轴距
frontTread	string	前轮距
rearTread	string	后轮距
curbWeight	string	整备质量
loadWeight	string	核定载质量

6.车辆参数信息查询

有关车辆VIN和发动机相关信息验证

https://www.253.com/#/data/product_main/93

测试：

6.1 请求参数：

​ 车辆识别码vin

6.2 响应参数

{
   
    "tradeNo": "666226438298537984",
    "chargeStatus": 1,
    "message": "成功",
    "data": {
   
        "MESSAGE": "查询成功，查询有结果",
        "guid": "20200113102600_W5292w76_4055696",
        "mvTrackId": "20200113102600_chuanglan_bCVbwuzc",
        "detail": {
   
            "resultCode": "1001",
            "resultInfo": {
   
                "modelNameId": "",
                "cc": "1.4",
                "modeiId": "47021",
                "maxJourney": "96(131)/5000",
                "passengers": "5",
                "engineModel": "CFB",
                "crossWeight": "1910",
                "bodyColor": "反射银",
                "engineNumber": "J52664",
                "batch": "",
                "typeName": "速腾1.4T-A/MT豪华型惠民补贴DSG双离合(国Ⅳ)",
                "effluentStandard": "国Ⅳ",
                "modelName": "速腾1.4T-A/MT豪华型惠民补贴DSG双离合(国Ⅳ)",
                "curbWeight": "1405",
                "brandId": "",
                "modelDate": "2010",
                "vin": "LFV2A21K6A3092399",
                "dateIssuing": "",
                "oilConsumption": "6.5000",
                "brand": "大众",
                "vehicleType": "紧凑型轿车",
                "makeDate": "2010-11-02"
            },
            "resultMsg": "查得数据"
        },
        "RESULT": "1"
    },
	"code": "200000"
}

7. 车辆保养记录查询

7.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	api.253.com/open/clwbxx/clbyjucx

7.2 请求参数

请求参数Body以x-www-form-urlencoded提交

参数名	类型	是否必填	说明
appId	String	是	请在api.253.com登录后获取
appKey	String	是	请在api.253.com登录后获取
Vin	String	是	机架号
asynAddress	String	否	异步通知地址
brand	String	否	品牌ID（32位）
engineNumber	String	否	发动机号（目前“广汽传祺”、“长安铃木”此两种品牌需要传入“车架号+发动机号”）

7.3 响应参数

响应body数据为JSON格式

字段名	类型	说明
chargeStatus	Int	是否收费：1收费，0不收费
code	String	响应code码。200000：成功，其他失败。见附录响应code码
message	String	响应code码解释
data	Object	返回对象
MESSAGE	String	请求结果描述
guid	string	会话号
mvTrackId	string	交易流水号
RESULT	string	状态码
detail	string	服务详情
resultInfo	object	详情信息
orderId	string	订单号
data	array	信息详情
repairType	string	维修类型
lastTime	string	进厂时间
mileage	String	公里数
vin	string	车架号
Details	string	维修详情
content	string	项目详情
type	string	维修类型
materials	string	材料详情
carInfo	object	车辆信息
engineNum	string	发动机缸数
transmissionType	string	变速箱类型
airBag	string	安全气囊
vehicleType	string	车辆类型
manufacturer	string	厂家名称
doorCount	string	车门数量
modelName	string	车型名称
jetType	string	发动机喷射类型
assemblyFactory	string	组装厂
makeDate	string	生产年份
vin	string	VIN码
journey	string	功率（Kw/R）
passengers	string	座位数
curbWeight	string	装备质量（KW）
brandName	string	品牌名称
cylinderForm	string	气缸形式
stallNumber	string	档位个数
carBody	string	车身形式
engineModel	string	发动机型号
fuelType	string	燃料种类
cc	string	排量（L）
saleName	string	销售名称
vehicleLevel	string	车辆级别
bodyColor	string	车身颜色
factoryType	string	厂家类型

8.银行卡四要素详细版

https://www.253.com/#/data/product_main/13

8.1 协议说明

名称	说明
协议	HTTPS POST
编码格式	UTF8
返回类型	application/json
URL	https://api.253.com/open/bankcard/card-auth-detail

8.2 请求参数

请求参数Body以multipart/form-data方式提交。

参数名	说明
appId	请在api.253.com登录后获取