第三方API文档

此文档详尽列举了各类第三方API接口,包括车辆违章记录查询、驾驶证信息核查、车辆参数信息、身份证验证等多个方面的服务。每个接口都包含协议说明、请求参数和响应参数,涉及的数据验证和识别服务广泛,适用于车辆管理、金融服务和实名认证等多个场景。

第三方API文档整理

创蓝

1. 车辆违章记录查询

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

1.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLapi.253.com/open/kdwl/vehicle_violation
1.2 请求参数

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

参数名是否必填类型说明
appIdString请在api.253.com登录后获取
appKeyString请在api.253.com登录后获取
carnoString车牌号
cartypeString?车辆类型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,新能源-小型汽车
framenoString车架号,支持后6位查询,或全位查询
enginenoString发动机号,支持后6位查询,或全位查询
1.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
codeintdata内参数:状态码,200为成功,其它为失败
msgstringdata内参数:状态码对应的说明描述
dataobjectdata内参数:查询结果详细信息
+order_nostring订单号
+car_nostring车牌号
+vio_totalstring违章条数
+find_totalstring违章罚款合计
+score_totalstring违章积分合计
+detailsarray违章详情;没有违章时为空数组
++vio_timestring违章时间
++vio_addressstring违章地址
++vio_actionstring违章行为
++vio_finestring违章罚款
++vio_scorestring违章记分
++vio_city_namestring违章所在城市名称
++vio_citystring违章所在城市代码
++vio_codestring违法代码
++col_organstring采集机构
++decision_numstring决定书编号
++monitor_numstring监控编号
++handle_signstring处理标记,返回值:1:未处理 未缴费 2:已处理 未缴费 3:已处理 已缴费 为空或不存在值时,默认为:未处理 未缴费。
++handle_numstring处理编号 在线处理时,传该编号。
++online_handlestring在线处理,返回值: 1:可以处理;2:不支持处理 为空或不存在结果时,默认为:不支持处理。


驾驶证信息核查

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

1. 驾驶证信息核查
1.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/dianhuabq/driver_license
1.2 请求参数

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

参数名类型是否必填说明
appIdString请在api.253.com登录后获取
appKeyString请在api.253.com登录后获取
driversLicenseNoString驾驶证证件号
1.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
codeStringdata内参数:返回码
messagestringdata内参数:返回码描述
resultstringdata内参数:返回数据信息
resstringresult内参数:状态码
driversLicenseNoobjectresult内参数:驾驶证证件号
modelsstringresult内参数:准驾车型 A1 大型客车、A2 牵引车、A3 城市公交车 B1 中型客车、B2 大型货车 C1 小型汽车、C2 小型自动挡汽车、C3 三轮汽车、C4 低速载货汽车 D 三轮摩托车、E 二轮摩托车、F 轻便摩托车 M 轮式自行机械车、N 无轨电车、P 有轨电车
scoringObjectresult内参数:累计扣分
statestringresult内参数:驾驶证状态
startGetLicensingTimestringresult内参数:初次领证时间
endGetLicensingTimestringresult内参数:驾驶证有效时间至
fileNoStringresult内参数:档案编号

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

2.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/kdwl/driver_score
2.2 请求参数

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

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

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
codeStringdata内参数:返回码
messagestringdata内参数:返回码描述
resultstringdata内参数:返回数据信息
scorestringresult内参数:扣分总数。查询失败时,此字段不存在

3. 驾驶证信息查询

3.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/jszhy/jszxxcx
3.2 请求参数

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

参数名类型是否必填说明
appIdString请在api.253.com登录后获取
appKeyString请在api.253.com登录后获取
idCardString驾驶证号
3.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
mvTrackIdString交易流水
guidstring会话号
detailstring服务详情
RESULTstring返回状态码
MESSAGEstring状态详情
resultCodestring返回状态码
resultMsgstring详细信息
idCardstring驾驶证号
quasiDrivingTypestring准驾车型
scoringstring累计计分
driverStatusstring驾驶证状态
namestring姓名
firstIssueDatestring初次领证日期
termoFvaliditystring有效期至
fileNumberstring档案编号
trafficpolicestring状态码描述
resultMsgstring签发机关
startDatestring有效期始

4. 驾驶证基本信息核验

4.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLapi.253.com/open/jszjf/drivingliver
4.2 请求参数

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

参数名类型是否必填说明
appIdString请在api.253.com登录后获取
appKeyString请在api.253.com登录后获取
nameString姓名
idCardString身份证号
firstIssueDateString初次领证日期 ( yyyy-MM-dd)
quasiDrivingTypeString准驾车型
4.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
resultCodeString状态码(1001:验证一致;1002:验证不一致;2001:无数据,3002:参数错误;9999:服务异常)
resultMsgstring状态码描述


5. 车辆行驶证核查

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

5.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/xszhy/xszdxhy
5.2 请求参数

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

参数名类型是否必填说明
appIdString请在api.253.com登录后获取
appKeyString请在api.253.com登录后获取
plateNumberString车架号
plateTypeString车牌号
brandNameString号牌种类,车型 01,大型汽车;02,小型汽车;03,使馆汽车; 04,领馆汽车;05,境外汽车;06,外籍汽车; 07,两、三轮摩托车;08,轻便摩托车;09,使馆摩托车; 10,领馆摩托车;11,境外摩托车;12,外籍摩托车; 13,农用摩托车;14,拖拉机;15,挂车; 16,教练汽车;17,教练摩托车;20,临时入境汽车; 21,临时入境摩托车;22,临时行驶车;23,警用汽车;24,警用摩托;51,新能源大型车;52,新能源小型车
bodyColorString车身颜色
useTypeString使用性质
vehicleModelcString车牌型号
vehicleTypeString车辆类型
engineNumberString发动机号
engineModelString发动机型号
vinString车架号
firstIssueDateString初次登记日期
validityDayEndString校验有效日期
ownerString机动车所有人
vehicleStatusString车辆状态
passengersString核定载客数
retirementDateString强制报废期止
fuelTypeString燃料种类, A 汽油 B 柴油 C 电驱动(电能驱动汽车) D 混合油 E 天然气 F 液化石油气 L 甲醇 M 乙醇 N 太阳能 O 混合动力 Y 无(仅限全挂车等无动力的) Z 其他 P 插电式混合动力 Q 氢气
ccString排量
ppsDateString出厂日期
maxJourneyString最大功率
shaftString轴数
wheelBaseString轴距
frontTreadString前轮距
rearTreadString后轮距
crossWeightString总质量
curbWeightString整备质量
loadWeightString核定载质量
brandNameString品牌名称
5.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
guidString会话号
mvTrackIdstring交易流水号
RESULTstring状态码
MESSAGEstring状态描述信息,结果说明
detailobject服务详情
brandNamestring品牌名称
bodyColorstring车身颜色
useTypestring使用性质
vehicleModelcstring车牌型号
vehicleTypestring车辆类型
engineNumberString发动机号
engineModelstring发动机型号
vinstring车架号
firstIssueDatestring初次登记日期
validityDayEndstring检验有效期止
ownerstring机动车所有人
vehicleStatusstring车辆状态
passengersstring核定载客数
retirementDatestring强制报废期止
fuelTypestring燃料种类
ccstring排量
ppsDatestring出厂日期
maxJourneystring最大功率(KW)
shaftstring轴数
wheelBasestring轴距
frontTreadstring前轮距
rearTreadstring后轮距
curbWeightstring整备质量
loadWeightstring核定载质量

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
URLapi.253.com/open/clwbxx/clbyjucx
7.2 请求参数

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

参数名类型是否必填说明
appIdString请在api.253.com登录后获取
appKeyString请在api.253.com登录后获取
VinString机架号
asynAddressString异步通知地址
brandString品牌ID(32位)
engineNumberString发动机号(目前“广汽传祺”、“长安铃木”此两种品牌需要传入“车架号+发动机号”)
7.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
MESSAGEString请求结果描述
guidstring会话号
mvTrackIdstring交易流水号
RESULTstring状态码
detailstring服务详情
resultInfoobject详情信息
orderIdstring订单号
dataarray信息详情
repairTypestring维修类型
lastTimestring进厂时间
mileageString公里数
vinstring车架号
Detailsstring维修详情
contentstring项目详情
typestring维修类型
materialsstring材料详情
carInfoobject车辆信息
engineNumstring发动机缸数
transmissionTypestring变速箱类型
airBagstring安全气囊
vehicleTypestring车辆类型
manufacturerstring厂家名称
doorCountstring车门数量
modelNamestring车型名称
jetTypestring发动机喷射类型
assemblyFactorystring组装厂
makeDatestring生产年份
vinstringVIN码
journeystring功率(Kw/R)
passengersstring座位数
curbWeightstring装备质量(KW)
brandNamestring品牌名称
cylinderFormstring气缸形式
stallNumberstring档位个数
carBodystring车身形式
engineModelstring发动机型号
fuelTypestring燃料种类
ccstring排量(L)
saleNamestring销售名称
vehicleLevelstring车辆级别
bodyColorstring车身颜色
factoryTypestring厂家类型

8.银行卡四要素详细版

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

8.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/bankcard/card-auth-detail
8.2 请求参数

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
name姓名
idNum身份证号码,限单个
cardNo银行卡号,限单个
mobile非必传,银行预留手机号码,限单个,仅支持国内号码,11位
8.3 响应内容

响应body数据为JSON格式。

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录5.1响应code码
messageString响应code码解释
chargeStatusString是否收费,枚举值:1 :收费 0:不收费
dataObject
orderNoString业务唯一流水号
handleTimeString查询时间。样例:2018-04-09 15:05:01
resultString认证结果代码。01:认证一致02:认证不一致03:认证不确定04:认证失败05:手机号码不匹配06:身份证号码不匹配07:姓名不匹配01, 02, 05, 06, 07的代码收费,其他不收费
bankNameString银行卡所属银行。样例:招商银行
cardTypeString银行卡类型 样例:金穗借记卡
cardCategoryString银行卡类别 样例:借记卡
remarkString备注。样例:信息认证未通过(验证不一致)

9.银行卡四要素标准版

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

9.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/bankcard/card-auth
9.2请求参数

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
name姓名
idNum身份证号码,限单个
cardNo银行卡号,限单个
mobile非必传,银行预留手机号码,限单个,仅支持国内号码,11位
9.3 响应内容

响应body数据为JSON格式。

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录5.1响应code码
messageString响应code码解释
chargeStatusString是否收费,枚举值:1 :收费 0:不收费
dataObject
orderNoString业务唯一流水号
handleTimeString查询时间。样例:2018-04-09 15:05:01
resultString认证结果。01:一致 02:不一致 03:认证不确定 04:认证失败。01、02收费
bankNameString银行卡所属银行。样例:招商银行
cardTypeString银行卡类型 样例:金穗借记卡
cardCategoryString银行卡类别 样例:借记卡
remarkString备注。样例:信息认证未通过(验证不一致)

10.图片审核----GIF色情图像识别

10.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLapi.253.com/open/nrsh/detect_gif
10.2 请求参数

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
image图像数据,base64编码。gif格式,每帧编码后大小< 4M,帧数不超过50,GIF图片整体大小base64编码后不超过20M
10.3 响应参数

响应body数据为JSON格式

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject识别结果。各具体字段: class_name,分类结果名称;probability,分类结果置信度

11.图片审核 ---- 组合服务接口

11.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLapi.253.com/open/nrsh/img_censor
11.2 请求参数

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
image待审核图片Base64编码字符串,以图片文件形式请求时必填。不能与imgUrl并存。
imgUrl网图URL地址,以网图形式请求,图片Url需要做UrlEncode。不能与image并存。
scenes指定本次调用的模型服务,以字符串数组表示。元素含义如下: politician:政治敏感识别 antiporn:色情识别 terror:暴恐识别 disgust:恶心图像识别 watermark:广告检测 quality:图像质量检测
11.3 响应参数

响应body数据为JSON格式

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject识别结果。各具体字段:antiporn##result##class_name,分类标签名;antiporn##result##probability,分类标签置信度;antiporn##conclusion,分析结论;terror##result##name,分类标签名;terror##result##score,分类标签置信度;watermark##result_num,分析出的水印数量;disgust##result,是恶心图片的置信度;quality##clarity,图片清晰度;quality##aesthetic,图片美观度。

12.图片识别 ---- 车型识别

12.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLapi.253.com/open/txsb/chexing
12.2 请求参数

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
top_num返回结果top n,默认5,该参数为可选
image图像文件内容进行base64之后的值
12.3 响应内容

响应Body数据为JSON格式

字段名类型说明
codeString响应code码。200000:成功,其他失败。见响应code码
messageString响应code码解释
dataObject识别结果。各字段说明:name,车辆的品牌型号信息;score,识别结果置信度。

13.身份证校验V1(不带签名)

https://www.253.com/#/data/product_main/12?productCateCode=3&productCateName=%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81

13.1.协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/idcard/id-card-auth
13.2.请求参数说明

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
name姓名
idNum身份证号码
13.3.响应参数说明

响应body数据为JSON格式

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录5.1响应code码
messageString响应code码解释
dataObject
orderNoString业务唯一流水号。例:628291418130630
handleTimeString查询时间 例:2018-04-09 15:05:01
provinceString省份
cityString市区
countryString县区
birthdayString生日,格式是yyyyMMdd
ageString年龄
genderString性别:1:男、2:女
remarkString备注,例:一致
resultString返回结果: 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定(收费) 04-认证失败(不收费)

14.身份证校验V2(带签名版)

14.1.协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/idcard/id-card-auth/vs
14.2.请求参数说明

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

参数名说明
appId请在api.253.com登录后获取
name姓名
idNum身份证号码
sign签名。按appId+idNum+name顺序,将参数名称和值拼接,例如"appIdAbcd1234idNum430512198908131367name代用名",之后以appKey(控制台获得)为密钥, 使用hmacSHA1签名后经Base64编码得到。
14.3.响应参数说明

响应body数据为JSON格式

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录5.1响应code码
messageString响应code码解释
dataObject
orderNoString业务唯一流水号。例:628291418130630
handleTimeString查询时间 例:2018-04-09 15:05:01
provinceString省份
cityString市区
countryString县区
birthdayString生日,格式是yyyyMMdd
ageString年龄
genderString性别:1:男、2:女
remarkString备注,例:一致
resultString返回结果: 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定(收费) 04-认证失败(不收费)

15.运营商三要素

15.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/carriers/carriers-auth
15.2 请求参数说明

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
name姓名
idNum身份证号码
mobile手机号码
15.3 响应参数说明

响应body数据为JSON格式

字段名类型说明
codeString响应code码。200000:成功,其他失败。见附录5.1响应code码
messageString响应code码解释
chargeStatusString是否收费,枚举值:1 :收费 0:不收费
dataObject
orderNoString业务唯一流水号。例:628291418130630
handleTimeString查询时间 例:2018-04-09 15:05:01
typeString运营商类型:1、中国移动2、中国联通3、中国电信
ageString年龄
genderString性别:1:男、2:女
resultString认证结果,01-一致,02-不一致,03-不确定,04-失败
remarkString备注 ,例:一致

16. 快递物流

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

16.1 协议说明
名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLapi.253.com/open/kdwl/kdcx
16.2 请求参数

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

参数名说明
appId请在api.253.com登录后获取
appKey请在api.253.com登录后获取
timestamp客户端时间。 格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
gzip返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩
com快递公司字母简称。可以使用auto代替,此时将自动识别快递单号圆通:yuantong;高铁速递:gtsd;中通快递:zhongtong;申通快递:shentong;百世快递(原汇通):huitong;韵达快递:yunda;顺丰速运:shunfeng
nu运单号
senderPhone寄件人手机号后四位,顺丰需要填写
receiverPhone收件人手机号后四位,顺丰需要填写
16.3 响应参数

响应body数据为JSON格式

字段名类型说明
chargeStatusInt是否收费:1收费,0不收费
codeString响应code码。200000:成功,其他失败。见附录响应code码
messageString响应code码解释
dataObject返回对象
showapi_res_idstringdata内参数:本次请求ID
showapi_res_errorstringdata内参数:错误信息的展示
showapi_res_codeintdata内参数:0,成功;-1,系统调用错误; -2,可调用次数或者金额为0
showapi_res_bodyObjectdata内参数:查询结果的封装
expTextNamestringshowapi_res_body内参数:快递公司名称
expSpellNamestringshowapi_res_body内参数:快递公司英文
mailNostringshowapi_res_body内参数:快递单号
updatestringshowapi_res_body内参数:更新时间(时间戳)
telstringshowapi_res_body内参数:联系电话
dataarrayshowapi_res_body内参数:快递动态
contextstringshowapi_res_body内data数组元素内参数:快递最新动态
timestringshowapi_res_body内data数组元素内参数:最新动态对应时间
statusintshowapi_res_body内参数:快件签收状态。 -1 待查询 0 查询异常 1 暂无记录 2 在途中 3 派送中 4 已签收 5 用户拒签 6 疑难件 7 无效单 8 超时单 9 签收失败 10 退回
possibleExpListarrayshowapi_res_body内参数: 在auto的情况下,返回可能的快递列表simpleName快递简称、 expName快递公司名
ret_codeintshowapi_res_body内参数:查询是否成功
dataSizeintshowapi_res_body内参数:快递节点数量
msgstringshowapi_res_body内参数:返回说明信息
updateStrstringshowapi_res_body内参数:更新时间
flagstringshowapi_res_body内参数:成功或者失败的标识
queryTimesintshowapi_res_body内参数:当前快递单号每天查询总次数

聚合API

1.VIN码查询

**接口地址:**http://v.juhe.cn/vinParse/query.php

**返回格式:**json

**请求方式:**get post

请求示例:http://v.juhe.cn/vinParse/query.php?vin=LHGCP260*****&key=您申请的key

**接口备注:**根据VIN码准确定型,获取保险车辆列表(含配置信息) 包含:车型代码,唯一标识、车型名称、品牌名称、车系名称、车组名称、排量、发动机描述、发动机型号等等。

1.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
vinstring车架号
1.2 返回参数说明:
名称类型说明
error_codeint状态码
reasonstring状态描述
resultarray结果集
questionListarray返回车型问题集合
questionList说明
answerConentString答案选项
answerValueString答案值
questionString问题
yesFlagString答案选项
vehicleListarray返回后市场车型列表
vehicleList说明
brandNameString品牌名称
groupCodeString车组编码
groupNameString车组名称
vehicleIdString车型代码,唯一标识
vehicleNameString车型名称
importFlagString国产/进口
standardNameString车型俗称
displacementString排量
yearPatternString年款
uploadDateString出厂日期
standardname2String公告号
purchasePriceString新车购置价
gearboxTypeString变速箱类型
supplyOilString供油方式
fuelJetTypeString燃油喷射形式
engineModelString发动机型号
drivenTypeString驱动形式
remarkString备注
hasConfigString是否有更多配置
listPriceString厂商指导价
familyNameString车系名称
seatString座位数
cfgLevelString配置等级
marketDateString上市年份
vehicleSizeString外形尺寸
wheelbaseString轴距
gearNumString变速器档数
fullWeightString整备质量(千克)
powerString功率
bodyTypeString车身结构
effluentStandardString排放标准
vehicleColorString车身颜色
vehlsSeriString是否商用车(不一定有值)

2.车辆历史违章查询

2.1城市规则列表

接口地址:http://v.juhe.cn/wzHistory/city.php

**返回格式:**json

**请求方式:**get post

**请求示例:**http://v.juhe.cn/wzHistory/city.php?key=你申请的key

**接口备注:**获取城市查询违章的参数规则,建议每天更新一次

[API测试工具](javascript:frameLogin(9))

2.1.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
prefixstring对应车牌前缀
2.2.1 返回参数说明:
名称类型说明
error_codeint返回码(下面所有接口均有返回此字段,下面不再说明)
reasonstring提示信息(下面所有接口均有返回此字段,下面不再说明)
resultstring结果(下面所有接口均有返回此字段,下面不再说明)
prefixstring前缀
vinstring车架号长度((最后几位)车架长度,0为全部信息,-1为无需提供,其他为所需提供的长度值)
engine_nostring发动机号长度((最后几位)车架长度,0为全部信息,-1为无需提供,其他为所需提供的长度值)
statusboolean是否支持查询(1为支持查询,0为暂不支持查询)
2.2 查询历史违章记录

**接口地址:**http://v.juhe.cn/wzHistory/query.php

**返回格式:**json

**请求方式:**post

**请求示例:**http://v.juhe.cn/wzHistory/query.php?carNo=苏xxxxxx&vin=xxxx&engineNo=xxxx&type=02&key=你申请的key

**接口备注:**查询历史违章记录

[API测试工具](javascript:frameLogin(9))

2.2.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
carNostring车牌号
vinstring车架号(根据城市列表的规则决定长度)
engineNostring发动机号(根据城市列表的规则决定长度)
typestring车类型(默认02:小型车,支持大小车查询)
2.2.2 返回参数说明:
名称类型说明
wz_datestring违章时间
areastring违章地址
actstring违章行为
wz_codestring违法行为代码
fenint扣分
moneydouble罚款金额
handledint是否支持处理(1已处理,0未处理)
if_paidint是否缴费(1已缴费,0未缴费)
wz_citystring违章城市

3.全国违章直连查询

3.1 获取支持城市参数接口

**接口地址:**http://v.juhe.cn/sweizhang/citys

**返回格式:**json/xml

**请求方式:**get post

**请求示例:**http://v.juhe.cn/sweizhang/citys?key=key

**接口备注:**有些城市如果维护,我们会临时下线处理

API测试工具

3.1.1 请求参数说明:
名称必填类型说明
provinceNstring默认全部,省份简写,如:ZJ、JS
dtypeNstring返回数据格式:json或xml,默认json
keyYstring在个人中心->我的数据,接口名称上方查看
3.1.2 返回参数说明:
名称类型说明
province_codeString省份代码
provinceString省份名称
citysArray省份下开通城市数组
city_codeString城市代码
city_nameString城市名称
engineString是否需要发动机号0,不需要 1,需要
enginenoString需要几位发动机号0,全部 1-9 ,需要发动机号后N位
classString是否需要车架号0,不需要 1,需要
classaString同上,(解决java中class关键字无法映射)
classnoString需要几位车架号0,全部 1-9 需要车架号后N位
3.2 请求违章查询接口

**接口地址:**http://v.juhe.cn/sweizhang/query

**返回格式:**json/xml/jsonp

**请求方式:**post get

**请求示例:**http://v.juhe.cn/sweizhang/query?city=SH&hphm=苏L50A11&engineno=123456&key=key

**接口备注:**违章查询稳定性依赖交管方,交管方维护升级会导致部分城市查询不稳定;建议按照车牌地查询违章。

[API测试工具](javascript:frameLogin(9))

3.2.1 请求参数说明:
名称必填类型说明
dtypestring返回数据格式:json或xml,默认json
callbackString返回格式选择jsonp时,必须传递
keystring在个人中心->我的数据,接口名称上方查看
cityString(车牌所在地)城市代码
hphmString号牌号码 完整7位 ,需要utf8 urlencode*
hpzlstring号牌类型,默认02:小型车,01:大型车,52:新能源小型车,51:新能源大型车
enginenoString发动机号 (具体是否需要根据城市接口中的参数填写)
classnoString车架号 (具体是否需要根据城市接口中的参数填写)
3.2.2 返回参数说明:
名称类型说明
error_codeint状态码
provinceString查询省份代码
cityString查询城市代码
hphmString查询的号牌号码
listsArray违章列表
dateString违章时间
areaString违章地点
archivenostring文书编号(不一定获取到)
actString违章行为
codeString违章代码(仅供参考,不一定有值)
fenString违章扣分(仅供参考,不一定有值)
moneyString违章罚款(仅供参考,不一定有值)
handledString是否处理,1处理 0未处理 空未知
hpzlstring车牌类型(02小型车)
wzcitystring违章城市(仅供参考,不一定有值)
cjjgstring采集机关(不一定有值)
3.3 根据车牌前缀获取城市参数

**接口地址:**http://v.juhe.cn/sweizhang/carPre

**返回格式:**json

**请求方式:**get

**请求示例:**http://v.juhe.cn/sweizhang/carPre.php?key=&hphm=%E6%B2%AAC

**接口备注:**根据车牌前缀或车牌号码,获取对应的城市代码及违章查询条件参数

[API测试工具](javascript:frameLogin(9))

3.3.1 请求参数说明:
名称必填类型说明
keyYstring在个人中心->我的数据,接口名称上方查看
hphmString车牌前缀(前2位)或车牌号,如:浙A;需要utf8 urlencode
isNerint是否新能源,默认为0,可选参数0:否,1:是
3.3.2 返回参数说明:
名称类型说明
provinceString省份名称
city_codeString城市代码
city_nameString城市名称
abbrstring车牌前缀
engineString是否需要发动机号,0:不需要 1:需要
enginenoString需要几位发动机号0:全部 1-9 :需要发动机号后N位
classaString是否需要车架号,0:不需要 1:需要
classnoString需要几位车架号0:全部 1-9: 需要车架号后N位

4.证件识别

https://www.juhe.cn/docs/api/id/153

4.1 支持的证件类型清单

**接口地址:**http://v.juhe.cn/certificates/typeList.php

**返回格式:**json

**请求方式:**get/post

**请求示例:**http://v.juhe.cn/certificates/typeList.php?key=您申请的appkey

**接口备注:**查询支持的证件类型清单

[API测试工具](javascript:frameLogin(9))

4.1.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
4.1.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集
4.1.3 JSON返回示例:
{
    "reason": "操作成功",
    "error_code": 0,
    "result": {
        "1": "一代身份证",
        "2": "二代身份证正面",
        "3": "二代身份证证背面",
        "4": "临时身份证",
        "5": "驾照",
        "6": "行驶证",
        "7": "军官证",
        "9": "中华人民共和国往来港澳通行证(护照幅面)",
        "10": "台湾居民往来大陆通行证(护照幅面)",
        "11": "大陆居民往来台湾通行证(护照幅面)",
        "12": "签证(护照幅面)",
        "13": "护照(护照幅面)",
        "14": "港澳居民来往内地通行证正面(卡幅面)",
        "15": "港澳居民来往内地通行证背面(卡幅面)",
        "16": "户口本",
        "17": "银行卡",
        "19": "车牌",
        "20": "名片",
        "22": "卡式港澳台通行证",
        "25": "新版台湾居民往来大陆通行证正面",
        "26": "新版台湾居民往来大陆通行证背面",
        "28": "中国驾驶证副页",
        "101": "二代身份证正面背面自动分类",
        "1000": "居住证",
        "1001": "香港永久性居民身份证",
        "1002": "登机牌(拍照设备目前不支持登机牌的识别)",
        "1003": "边民证(A)(照片页)",
        "1004": "边民证(B)(个人信息页)",
        "1005": "澳门身份证",
        "1006": "领取凭证(AVA6支持)",
        "1007": "律师证(A)(信息页",
        "1008": "律师证(B) (照片页)",
        "1030": "全民健康保险卡",
        "1031": "台湾身份证正面",
        "1032": "台湾身份证背面",
        "2007":"VIN码",
        "2008":"营业执照"
    }
}
4.2 证件图片识别

**接口地址:**http://v.juhe.cn/certificates/query.php

**返回格式:**json

**请求方式:**post

**请求示例:**http://v.juhe.cn/certificates/query.php

**接口备注:**根据上传的图片文件和证件类型,进行证件识别结果返回,证件越清晰,识别准确率越高,建议图像分辨率为300DPI,建议图像文件大小在200KB以下。拍摄时请不要选择过高的分辨率拍摄,一方面造成图片过大,不利于传输,一方面分辨率过高也会影响识别率。拍摄时可以选择1280960分辨率拍摄(营业执照23002000~3000*3000),低一些的分辨率也可以选择,但是要确保图像文字清晰,银行卡识别只支持jpg格式的图片,只有状态码为0和215305时扣费

[API测试工具](javascript:frameLogin(9))

4.2.1 请求参数说明:
名称必填类型说明
keystring您申请的appkey
cardTypestring证件类型,参考接口1
picMultipartFile上传图片,大小限制在3M以内(一般建议200k以下)
useridstring用户单号
orderidstring传1表示需要返回聚合订单号,不输入或其他则不返回
4.2.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集

5.驾驶证识别

**接口地址:**http://apis.juhe.cn/drivingLicenseOcr/index

**返回格式:**json

**请求方式:**http post

**请求示例:**http://apis.juhe.cn/drivingLicenseOcr/index

**接口备注:**对机动车驾驶证所有关键字段进行识别

5.1 请求参数说明:
名称必填类型说明
imagestring图片,base64编码,编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 。注意:图片需要base64编码、去掉编码头后再进行urlencode。
detect_directionint是否检测图像朝向,默认不检测;1:检测 0:不检测
keystring在个人中心->我的数据,接口名称上方查看
5.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集

6.行驶证识别

**接口地址:**http://apis.juhe.cn/vehicleLicenseOcr/index

**返回格式:**json

**请求方式:**http post

**请求示例:**http://apis.juhe.cn/vehicleLicenseOcr/index

**接口备注:**对机动车行驶证主页字段进行结构化识别

6.1 请求参数说明:
名称必填类型说明
imagestring图片,base64编码,编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 。注意:图片需要base64编码、去掉编码头后再进行urlencode。
keystring在个人中心->我的数据,接口名称上方查看
6.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集
6.3 JSON返回示例:
{
  "reason": "success",
  "result": {
    "result_num": 10,
    "res": [
      {
        "name": "品牌型号",
        "value": "某某牌XXXXX"
      },
      {
        "name": "发证日期",
        "value": "20100000"
      },
      {
        "name": "使用性质",
        "value": "非营运"
      },
      {
        "name": "发动机号码",
        "value": "9999999"
      },
      {
        "name": "号牌号码",
        "value": "A88888"
      },
      {
        "name": "所有人",
        "value": "代用名"
      },
      {
        "name": "住址",
        "value": "某某市某某区某某路某某号"
      },
      {
        "name": "注册日期",
        "value": "20100000"
      },
      {
        "name": "车辆识别代号",
        "value": "XXXXX1234567890000"
      },
      {
        "name": "车辆类型",
        "value": "小型轿车"
      }
    ]
  },
  "error_code": 0
}

7.身份证实名认证

https://www.juhe.cn/docs/api/id/103

7.1 身份证实名查询

**接口地址:**http://op.juhe.cn/idcard/query

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://op.juhe.cn/idcard/query?key=您申请的KEY&idcard=&realname=

**接口备注:**error_code为0或者210301时计费

7.1.1 请求参数说明:
名称必填类型说明
idcardstring身份证号码
realnamestring姓名
orderidint传1时返回单号,默认不返回单号
keystring在个人中心->我的数据,接口名称上方查看
7.1.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultobject返回结果集
realnamestring属result,真实姓名
idcardstring属result,身份证号
resint属result,匹配详情,1匹配,2不匹配

JSON返回示例:

{
    "reason": "成功",
    "result": {
        "realname": "***",/*真实姓名*/
        "idcard": "******************",/*身份证号码*/
        "res": 1 /*1:匹配 2:不匹配*/
    },
    "error_code": 0
}
7.2 身份证实名查询(验签版本)

**接口地址:**http://op.juhe.cn/idcard/verifys

**返回格式:**json

**请求方式:**get/post

**请求示例:**http://op.juhe.cn/idcard/verifys?key=您申请的KEY&idcard=&realname=

**接口备注:**error_code为0时计费

7.2.1 请求参数说明:
名称必填类型说明
idcardstring身份证号码
realnamestring姓名(需utf8编码的urlencode)
keystring在个人中心->我的数据,接口名称上方查看
uorderidstring用户订单号(8-32位字母数字组合,需要唯一)
signstringmd5(openid+appkey+idcard+realname+uorderid)32位小写,openid在个人中心查询
7.2.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultobject返回结果集
realnamestring属result,真实姓名
idcardstring属result,身份证号
resint属result,匹配详情,1匹配,2不匹配
orderidstring属result,聚合订单号
7.3.3 JSON返回示例:
{
    "reason": "成功",
    "result": {
        "realname": "***",/*真实姓名*/
        "idcard": "******************",/*身份证号码*/
        "res": 1, /*1:匹配 2:不匹配*/
        "orderid":"J103201712261751495244"/*聚合订单号*/
    },
    "error_code": 0
}
7.3 身份证实名查询(加密版)

**接口地址:**http://op.juhe.cn/idcard/queryEncry

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://op.juhe.cn/idcard/queryEncry?key=您申请的KEY&idcard=&realname=

**接口备注:**error_code为0或者210301时计费

7.3.1 请求参数说明:
名称必填类型
idcardstring
realnamestring
keystring
7.3.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultobject返回结果集
resint属result,匹配详情,1匹配,2不匹配
orderidstring属result,单号
7.3.3 JSON返回示例:
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
    "reason": "成功",
    "result": {
       "orderid":"J103201911121607589548",/*单号*/[/color]
        "res": 1 /*1:匹配 2:不匹配*/
    },
    "error_code": 0
}

8.银行卡三元素检测

https://www.juhe.cn/docs/api/id/207

8.1 银行卡三元素检测普通版

**接口地址:**http://v.juhe.cn/verifybankcard3/query

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard3/query?key=&realname=&bankcard=&idcard=

**接口备注:**根据姓名+身份证号+银行卡卡号验证是否匹配

8.1.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名
idcardstring身份证号码
bankcardstring银行卡卡号
uorderidstring用户订单号,8到32位数字字母组合,要保证唯一
isshowint是否显示匹配信息,0默认不显示,1显示
8.1.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
jobidstring本次查询流水号
bankcardstring银行卡卡号
realnamestring姓名
idcardstring身份证号码
resint匹配结果,1:匹配 2:不匹配
messagestring只有参数isshow不为空且不为0时显示
8.1.3 JSON返回示例:
{
    "reason": "成功",
    "result": {
        "jobid": "JH2071191112162139847181e7",
        "bankcard": "*************",
        "realname": "***",
        "idcard": "***************",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}
8.2 银行卡三元素检测(验签版)

**接口地址:**http://v.juhe.cn/verifybankcard3/verify

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard3/verify?key=&realname=&bankcard=&idcard=&sign=

**接口备注:**根据姓名+身份证号+银行卡卡号验证是否匹配

请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名,需要utf8 Urlencode
idcardstring身份证号码
bankcardstring银行卡卡号
uorderidstring用户订单号,不超过32位,要保证唯一
isshowint是否显示匹配信息,0默认不显示,1显示
signstringmd5(openid+appkey+bankcard+realname+idcard),openid在个人中心查询
返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
jobidstring本次查询流水号
bankcardstring银行卡卡号
realnamestring姓名
idcardstring身份证号码
resint匹配结果,1:匹配 2:不匹配
messagestring只有参数isshow不为空且不为0时显示
JSON返回示例:
{
    "reason": "成功",
    "result": {
        "jobid": "2017052515514933954",
        "bankcard": "*****************",
        "realname": "**",
        "idcard": "*************",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}
8.3 银行卡鉴权2.0

**接口地址:**http://v.juhe.cn/verifybankcard3/query_v2

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard3/query_v2?key=&bankcard=&realname=&idcard=&mobile=&code=01&customer=

**接口备注:**根据姓名、身份证、银行卡、商户名称、场景检测信息是否匹配

[API测试工具](javascript:frameLogin(9))

8.3.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名
idcardstring身份证号码
bankcardstring银行卡卡号
idtypestring证件类型,具体见JSON示例。默认:01
uorderidstring用户订单号,8到32位数字字母组合,要保证唯一
isshowint是否显示匹配信息,0默认不显示,1显示
codestring发起交易商户业务编码, 具体见JSON示例,如:01
customerstring公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户
8.3.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
jobidstring本次查询流水号
bankcardstring银行卡卡号
realnamestring姓名
idcardstring身份证号码
resint匹配结果,1:匹配 2:不匹配
messagestring只有参数isshow不为空且不为0时显示
8.3.3 JSON返回示例:
/**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/
{
    "reason": "成功",
    "result": {
        "jobid": "JH2071191112162139847181e7",
        "bankcard": "*************",
        "realname": "***",
        "idcard": "***************",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}
8.4 银行卡三元素检测加密版

**接口地址:**http://v.juhe.cn/verifybankcard3/queryEncry

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard3/queryEncry?key=&realname=&bankcard=&idcard=

**接口备注:**根据姓名+身份证号+银行卡卡号验证是否匹配

[API测试工具](javascript:frameLogin(9))

8.4.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名加密
idcardstring身份证号码加密
bankcardstring银行卡卡号加密
8.4.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
jobidstring本次查询流水号
resint匹配结果,1:匹配 2:不匹配
messagestring只有参数isshow不为空且不为0时显示
8.4.3 JSON返回示例:
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
    "reason": "成功",
    "result": {
        "jobid": "JH2071191112162139847181e7",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}
8.5 银行卡鉴权2.0加密版

**接口地址:**http://v.juhe.cn/verifybankcard3/queryEncry_v2

**返回格式:**json

**请求方式:**get/post

**请求示例:**http://v.juhe.cn/verifybankcard3/queryEncry_v2?key=&bankcard=&realname=&idcard=&mobile=&code=01&customer=

**接口备注:**根据姓名、身份证、银行卡、商户名称、场景检测信息是否匹配

8.5.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名加密
idcardstring身份证号码加密
bankcardstring银行卡卡号加密
idtypestring证件类型,具体见JSON示例。默认:01
codestring发起交易商户业务编码, 具体见JSON示例,如:01
customerstring公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户
8.5.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
jobidstring本次查询流水号
resint匹配结果,1:匹配 2:不匹配
messagestring只有参数isshow不为空且不为0时显示
8.5.3 JSON返回示例:
/**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/
 
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
    "reason": "成功",
    "result": {
        "jobid": "JH2071191112162139847181e7",
        "res": 2,
        "message": "认证信息不匹配,银行卡无效"
    },
    "error_code": 0
}

9.银行卡四元素校验

https://www.juhe.cn/docs/api/id/213

9.1 银行卡四元素检测

**接口地址:**http://v.juhe.cn/verifybankcard4/queryEncry_v2

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard4/queryEncry_v2?key=&bankcard=&realname=&idcard=&mobile=&code=01&customer=

**接口备注:**根据姓名、身份证、银行卡、手机号码、商户名称、场景检测信息是否匹配

9.1.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名加密
idcardstring身份证号码加密
bankcardstring银行卡卡号加密
mobilestring手机号码加密
codestring发起交易商户业务编码, 具体见JSON示例,如:01
customerstring公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户;
idtypestring证件类型,具体见JSON示例。默认:01
9.1.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
resstring匹配结果,1:匹配 2:不匹配
jobidstring本次查询流水号
8.1.3 JSON返回示例:
/**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/

 
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
    "reason": "成功",
    "result": {
        "jobid": "JH2131191113105116991630Np",/*本次查询流水号*/ 
        "res": "2",/*验证结果,1:匹配 2:不匹配*/
        "message": "认证信息不匹配"/*描述*/
    },
    "error_code": 0
}
9.2 银行卡四元素检测

**接口地址:**http://v.juhe.cn/verifybankcard4/verify

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard4/verify?key=&realname=&idcard=&bankcard=&mobile=&sign=

**接口备注:**根据姓名、身份证、银行卡、手机号码,检测信息是否匹配

9.2.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名
idcardstring身份证号码
bankcardstring银行卡卡号
mobilestring手机号码
uorderidstring用户订单号,不超过32位,要保证唯一
signstringmd5(openid+appkey+bankcard+realname+idcard+mobile),openid在个人中心查询
9.2.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
bankcardstring银行卡卡号
realnamestring姓名
idcardstring身份证号码
resstring匹配结果,1:匹配 2:不匹配
jobidstring本次查询流水号
mobilestring手机号码
9.2.3 JSON返回示例:
{
    "reason": "成功",
    "result": {
        "jobid": "2015120913503797592",/*本次查询流水号*/
        "realname": "***",/*姓名*/
        "bankcard": "***************",/*银行卡卡号*/
        "idcard": "*******************",/*身份证号码*/
        "mobile": "********",/*预留手机号码*/
        "res": "2",/*验证结果,1:匹配 2:不匹配*/
        "message": "认证信息不匹配"/*描述*/
    },
    "error_code": 0
}
9.3 银行卡鉴权2.0

**接口地址:**http://v.juhe.cn/verifybankcard4/query_v2

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard4/query_v2?key=&bankcard=&realname=&idcard=&mobile=&code=01&customer=

**接口备注:**根据姓名、身份证、银行卡、手机号码、商户名称、场景检测信息是否匹配

9.3.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名
idcardstring身份证号码
bankcardstring银行卡卡号
mobilestring手机号码
codestring发起交易商户业务编码, 具体见JSON示例,如:01
customerstring公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户;
idtypestring证件类型,具体见JSON示例。默认:01
uorderidstring用户订单号,不超过32位,要保证唯一
9.3.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
bankcardstring银行卡卡号
realnamestring姓名
idcardstring身份证号码
resstring匹配结果,1:匹配 2:不匹配
jobidstring本次查询流水号
mobilestring手机号码
9.3.3 JSON返回示例:
/**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/
{
    "reason": "成功",
    "result": {
        "jobid": "2015120913503797592",/*本次查询流水号*/
        "realname": "***",/*姓名*/
        "bankcard": "***************",/*银行卡卡号*/
        "idcard": "*******************",/*身份证号码*/
        "mobile": "********",/*预留手机号码*/
        "res": "2",/*验证结果,1:匹配 2:不匹配*/
        "message": "认证信息不匹配"/*描述*/
    },
    "error_code": 0
}
9.4 银行卡四元素检测(加密版)

**接口地址:**http://v.juhe.cn/verifybankcard4/queryEncry

**返回格式:**json

**请求方式:**get/post

**请求示例:**http://v.juhe.cn/verifybankcard4/queryEncry?key=&bankcard=&realname=&idcard=&mobile=

**接口备注:**根据姓名、身份证、银行卡、手机号码,检测信息是否匹配

9.4.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名加密
idcardstring身份证号码加密
bankcardstring银行卡卡号加密
mobilestring手机号码加密
9.4.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
resstring匹配结果,1:匹配 2:不匹配
jobidstring本次查询流水号
9.4.3 JSON返回示例:
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
    "reason": "成功",
    "result": {
        "jobid": "JH2131191113105116991630Np",/*本次查询流水号*/   
        "res": "2",/*验证结果,1:匹配 2:不匹配*/
        "message": "认证信息不匹配"/*描述*/
    },
    "error_code": 0
}
9.5 银行卡鉴权2.0(加密版)

**接口地址:**http://v.juhe.cn/verifybankcard4/queryEncry_v2

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://v.juhe.cn/verifybankcard4/queryEncry_v2?key=&bankcard=&realname=&idcard=&mobile=&code=01&customer=

**接口备注:**根据姓名、身份证、银行卡、手机号码、商户名称、场景检测信息是否匹配

9.5.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
realnamestring姓名加密
idcardstring身份证号码加密
bankcardstring银行卡卡号加密
mobilestring手机号码加密
codestring发起交易商户业务编码, 具体见JSON示例,如:01
customerstring公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户;
idtypestring证件类型,具体见JSON示例。默认:01
9.5.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回码描述
resstring匹配结果,1:匹配 2:不匹配
jobidstring本次查询流水号
9.5.3 JSON返回示例:
/**code 商户业务编码		|		idtype 证件类型
01 直销银行			|		01	身份证
02 消费金融			|		02	护照
03 银行二三类账户开户		|		03	港澳证
04 征信				|		04	台胞证
05 保险				|
06 基金				|
07 证券				|
08 租赁				|
09 海关申报			|
99 其他				|
*/

 
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16{
    "reason": "成功",
    "result": {
        "jobid": "JH2131191113105116991630Np",/*本次查询流水号*/ 
        "res": "2",/*验证结果,1:匹配 2:不匹配*/
        "message": "认证信息不匹配"/*描述*/
    },
    "error_code": 0
}

10.常用快递

https://www.juhe.cn/docs/api/id/43

10.1 常用快递查询API

**接口地址:**http://v.juhe.cn/exp/index

**返回格式:**json/xml

**请求方式:**http post/get

**请求示例:http://v.juhe.cn/exp/index?key=key&com=sf&no=575677355677接口地址:**http://v.juhe.cn/exp/index

**返回格式:**json/xml

**请求方式:**http post/get

**请求示例:**http://v.juhe.cn/exp/index?key=key&com=sf&no=575677355677

10.1.1 请求参数说明:
名称必填类型说明
comstring需要查询的快递公司编号
nostring需要查询的快递单号
senderPhoneint寄件人手机号后四位,顺丰快递需要提供senderPhone和receiverPhone其中一个
receiverPhoneint收件人手机号后四位,顺丰快递需要提供senderPhone和receiverPhone其中一个
keystring在个人中心->我的数据,接口名称上方查看
dtypestring返回数据的格式,xml或json,默认json
10.1.2 返回参数说明:参考JSON返回示例
10.1.3 JSON返回示例:
/* 以下内容仅作为格式上的参考 */

{
  "resultcode": "200", /* 老版状态码,新用户请忽略此字段 */
  "reason": "查询物流信息成功",
  "result": {
    "company": "EMS", /* 快递公司名字 */
    "com": "ems",
    "no": "1186465887499", /* 快递单号 */
    "status": "1", /* 1表示此快递单的物流信息不会发生变化,此时您可缓存下来;0表示有变化的可能性 */,
    "status_detail": "PENDING", /* 详细的状态信息,可能为null,仅作参考。其中:
        PENDING 待查询
        NO_RECORD 无记录
        ERROR 查询异常
        IN_TRANSIT 运输中
        DELIVERING 派送中
        SIGNED 已签收
        REJECTED 拒签
        PROBLEM 疑难件
        INVALID 无效件
        TIMEOUT 超时件
        FAILED 派送失败
        SEND_BACK 退回
        TAKING 揽件 */
    "list": [
      {
        "datetime": "2016-06-15 21:44:04",  /* 物流事件发生的时间 */
        "remark": "离开郴州市 发往长沙市【郴州市】", /* 物流事件的描述 */
        "zone": "" /* 快件当时所在区域,由于快递公司升级,现大多数快递不提供此信息 */
      },
      {
        "datetime": "2016-06-15 21:46:45",
        "remark": "郴州市邮政速递物流公司国际快件监管中心已收件(揽投员姓名:侯云,联系电话:)【郴州市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-16 12:04:00",
        "remark": "离开长沙市 发往贵阳市(经转)【长沙市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-17 07:53:00",
        "remark": "到达贵阳市处理中心(经转)【贵阳市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 07:40:00",
        "remark": "离开贵阳市 发往毕节地区(经转)【贵阳市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 09:59:00",
        "remark": "离开贵阳市 发往下一城市(经转)【贵阳市】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 12:01:00",
        "remark": "到达  纳雍县 处理中心【毕节地区】",
        "zone": ""
      },
      {
        "datetime": "2016-06-18 17:34:00",
        "remark": "离开纳雍县 发往纳雍县阳长邮政支局【毕节地区】",
        "zone": ""
      },
      {
        "datetime": "2016-06-20 17:55:00",
        "remark": "投递并签收,签收人:单位收发章 *【毕节地区】",
        "zone": ""
      }
    ]
  },
  "error_code": 0 /* 错误码,0表示查询正常,其他表示查询不到物流信息或发生了其他错误 */
}

10.2 快递公司编号对照表(查询支持的快递公司)

**接口地址:**http://v.juhe.cn/exp/com

**返回格式:**json/xml/jsonp

**请求方式:**http post get

**请求示例:**http://v.juhe.cn/exp/com?key=key

10.2.1 请求参数说明:无
10.2.2 返回参数说明:无
10.2.3 JSON返回示例:
/* 以下快递公司列表仅作为格式上的说明,实际支持的列表以接口实时返回的数据为准 */

{
  "resultcode": "200",
  "reason": "查询支持的快递公司成功",
  "result": [
    {
      "com": "顺丰",
      "no": "sf"
    },
    {
      "com": "申通",
      "no": "sto"
    },
    {
      "com": "圆通",
      "no": "yt"
    },
    {
      "com": "韵达",
      "no": "yd"
    },
    {
      "com": "天天",
      "no": "tt"
    }
    ......有省略
  ],
  "error_code": 0
}

11.加油卡充值

11.1 提交加油卡充值

**接口地址:**http://op.juhe.cn/ofpay/sinopec/onlineorder

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://op.juhe.cn/ofpay/sinopec/onlineorder

接口备注:正式使用后建议个人中心绑定IP白名单。加油卡完成网上充值后,需到所充值油卡当地加油站请工作人员进行激活(圈存)操作,否则充值金额将无法生效。发票等相关问题请联系客服。 如果充值过程中,遇到http网络状态异常或返回系统异常,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!**

11.1.1 请求参数说明:
名称必填类型说明
proidint产品id: 10000(中石化50元加油卡)[暂不支持] 10001(中石化100元加油卡) 10002(中石化200元加油卡) 10003(中石化500元加油卡) 10004(中石化1000元加油卡) 10007(中石化任意金额充值)[暂不支持] 10008(中石油任意金额充值))
cardnumstring充值数量(产品id为10007、10008时为具体充值金额(整数),其余产品id请传固定值1);注:中石油任意冲(产品id:10008)暂时只支持100\200\500\1000
orderidstring商家订单号,8-32位字母数字组合
game_useridstring加油卡卡号,中石化:以100011开头的19位卡号、中石油:以90开头的16位卡号
gasCardTelstring持卡人手机号码,可以填写一个固定格式的手机号码,如:18900000000;为了保证充值质量,中石油充值请传递加油卡账号的绑卡手机号。
gasCardNamestring持卡人姓名
chargeTypeint加油卡类型 (1:中石化、2:中石油;默认为1)
keystring在个人中心->我的数据,接口名称上方查看
signstring校验值,md5(OpenID+key+proid+cardnum+game_userid+orderid),OpenID在个人中心查询。加密结果转为32位小写
11.1.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集
11.1.3 JSON返回示例:
{
    "reason": "提交充值成功",
    "result": {
        "cardnum": "1", /*充值数量*/
        "ordercash": "100", /*售价*/
        "cardname": "全国加油卡", /*充值名称*/
        "sporder_id": "S20141125221812330", /*商家订单号*/
        "game_userid": "100011320000991****", /*加油卡卡号*/
        "game_state": "0", /*充值状态:0充值中 1成功 9撤销,刚提交成功的单子状态均为充值中*/
        "uorderid": "S2014111111115" /*商户自定的订单号*/
    },
    "error_code": 0
}
11.2 订单状态查询

**接口地址:**http://op.juhe.cn/ofpay/sinopec/ordersta

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://op.juhe.cn/ofpay/sinopec/ordersta?key=&orderid=S2014111111115

**接口备注:**根据用户的订单号查询状态,本接口暂只支持查询近60天订单,请务必确认订单已经成功提交后再查询,避免造成不必要的损失;如果查询过程中,遇到http网络状态异常或错误码返回系统异常10014,或联系客服,不要直接做失败处理,避免造成不必要的损失!!!

11.2.1 请求参数说明:
名称必填类型说明
orderidstring商家订单号,8-32位字母数字组合
keystring在个人中心->我的数据,接口名称上方查看
11.2.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集
11.2.3 JSON返回示例:
{
    "reason": "查询成功",
    "result": {
        "cardname": "全国 中石化加油 固定面值加油卡 直充100元",/*商品名称*/
        "game_userid": "1000119000002494353",/*加油卡卡号*/
        "uordercash": "100.000",/*订单消耗金额*/
        "sporder_id": "S17070400085272603302001",/*聚合订单号*/
        "game_state": "9",/*状态 1:成功 9:失败 0:充值中*/
        "err_msg": "只能给主卡且卡状态正常的加油卡充值"/*描述,订单失败时返回失败原因*/
    },
    "error_code": 0
}
11.3 状态回调配置

**接口地址:**您接收回调新的URL地址,联系客服配置

**返回格式:**接收到回调,请返回任意字符串

**请求方式:**http post

请求示例:

API测试工具

请求参数说明:

名称必填类型说明
聚合推送参数---
sporder_idstringY聚合订单号
orderidstringY用户自定义的单号
staintY充值状态1:成功 9:失败
signstringY校验值,md5(appkey+sporder_id+orderid) 32位小写,用于校验请求合法性
err_msgstringN状态描述信息(暂只支持油卡业务)

返回参数说明:

名称类型说明

JSON返回示例:

只有成功提交的订单才会有回调通知,如果提交订单是直接返回错误码,这部分单子不会发起回调通知。
详细说明可参考:http://code.juhe.cn/docs/detail/id/1565

处理成功请返回:success 或 任意字符串

重试机制:聚合数据在请求回调地址时,如果无任何内容返回或无响应,会重新发起最多3次,间隔3s左右

本回调推送内容格式适用于话费充值、油卡充值、流量充值等增值服务

如果需要状态回调的用户,如接口其他已经调试完毕,请将账号和回调地址发给在线客服,我们将回调地址配置线上。
11.4 订单状态查询

**接口地址:**http://op.juhe.cn/ofpay/sinopec/sordersta

**返回格式:**json

**请求方式:**http get/post

**请求示例:**http://op.juhe.cn/ofpay/sinopec/sordersta

**接口备注:**签名校验版,根据用户的订单号查询状态,本接口暂只支持查询近60天订单,根据用户的订单号查询状态,请务必确认订单已经成功提交后再查询,避免造成不必要的损失;如果查询过程中,遇到http网络状态异常或错误码返回系统异常10014,或联系客服,不要直接做失败处理,避免造成不必要的损失

11.4.1 请求参数说明:
名称必填类型说明
keystring在个人中心->我的数据,接口名称上方查看
orderidstring商家订单号,8-32位字母数字组合
timestampstring当前时间戳或随机数,如:1462502925
signstring校验值,md5(OpenID+key+orderid+timestamp),OpenID在个人中心查询
11.4.2 返回参数说明:
名称类型说明
error_codeint返回码
reasonstring返回说明
resultstring返回结果集
11.4.3 JSON返回示例:
{
    "reason": "查询成功",
    "result": {
        "cardname": "全国 中石化加油 固定面值加油卡 直充100元",/*商品名称*/
        "game_userid": "1000119000002494353",/*加油卡卡号*/
        "uordercash": "100.000",/*订单消耗金额*/
        "sporder_id": "S17070400085272603302001",/*聚合订单号*/
        "game_state": "9",/*状态 1:成功 9:失败 0:充值中*/
        "err_msg": "只能给主卡且卡状态正常的加油卡充值"/*描述,订单失败时返回失败原因*/
    },
    "error_code": 0
}
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值