第三方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登录后获取 |