第三方API文档整理
https://www.253.com/#/data/product_main/172
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/kdwl/vehicle_violation |
请求参数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位查询,或全位查询 |
响应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
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/dianhuabq/driver_license |
请求参数Body以x-www-form-urlencoded提交
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
appId | String | 是 | 请在api.253.com登录后获取 |
appKey | String | 是 | 请在api.253.com登录后获取 |
driversLicenseNo | String | 是 | 驾驶证证件号 |
响应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内参数:档案编号 |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/kdwl/driver_score |
请求参数Body以x-www-form-urlencoded提交
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
appId | String | 是 | 请在api.253.com登录后获取 |
appKey | String | 是 | 请在api.253.com登录后获取 |
city | String | 否 | 省市。支持范围: 北京,天津,上海,重庆,辽宁,吉林,黑龙江, 河北,山西,陕西,山东,安徽,河南,湖北,湖南,江西,福建,云南,海南,四川,贵州,广东, 甘肃,青海,西藏,新疆,广西,内蒙古,宁夏,湖州,嘉兴,杭州,绍兴,宁波,舟山,金华,衢州,丽水,台州, 温州,徐州,连云港,宿迁,盐城,淮安,扬州,泰州,南通,镇江,南京,常州,无锡,苏州 |
licenseNo | String | 是 | 驾驶证号码 |
fileNo | String | 是 | 档案编号 |
响应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内参数:扣分总数。查询失败时,此字段不存在 |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/jszhy/jszxxcx |
请求参数Body以x-www-form-urlencoded提交
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
appId | String | 是 | 请在api.253.com登录后获取 |
appKey | String | 是 | 请在api.253.com登录后获取 |
idCard | String | 是 | 驾驶证号 |
响应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 | 有效期始 |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/jszjf/drivingliver |
请求参数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 | 是 | 准驾车型 |
响应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 | 状态码描述 |
https://www.253.com/#/data/product_main/174
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/xszhy/xszdxhy |
请求参数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 | 否 | 品牌名称 |
响应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 | 核定载质量 |
有关车辆VIN和发动机相关信息验证
https://www.253.com/#/data/product_main/93
测试:
车辆识别码vin
{
"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"
}
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/clwbxx/clbyjucx |
请求参数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 | 否 | 发动机号(目前“广汽传祺”、“长安铃木”此两种品牌需要传入“车架号+发动机号”) |
响应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 | 厂家类型 |
https://www.253.com/#/data/product_main/13
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/bankcard/card-auth-detail |
请求参数Body以multipart/form-data方式提交。
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
appKey | 请在api.253.com登录后获取 |
name | 姓名 |
idNum | 身份证号码,限单个 |
cardNo | 银行卡号,限单个 |
mobile | 非必传,银行预留手机号码,限单个,仅支持国内号码,11位 |
响应body数据为JSON格式。
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录5.1响应code码 |
message | String | 响应code码解释 |
chargeStatus | String | 是否收费,枚举值:1 :收费 0:不收费 |
data | Object | |
orderNo | String | 业务唯一流水号 |
handleTime | String | 查询时间。样例:2018-04-09 15:05:01 |
result | String | 认证结果代码。01:认证一致02:认证不一致03:认证不确定04:认证失败05:手机号码不匹配06:身份证号码不匹配07:姓名不匹配01, 02, 05, 06, 07的代码收费,其他不收费 |
bankName | String | 银行卡所属银行。样例:招商银行 |
cardType | String | 银行卡类型 样例:金穗借记卡 |
cardCategory | String | 银行卡类别 样例:借记卡 |
remark | String | 备注。样例:信息认证未通过(验证不一致) |
https://www.253.com/#/data/product_main/13
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/bankcard/card-auth |
请求参数Body以multipart/form-data方式提交。
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
appKey | 请在api.253.com登录后获取 |
name | 姓名 |
idNum | 身份证号码,限单个 |
cardNo | 银行卡号,限单个 |
mobile | 非必传,银行预留手机号码,限单个,仅支持国内号码,11位 |
响应body数据为JSON格式。
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录5.1响应code码 |
message | String | 响应code码解释 |
chargeStatus | String | 是否收费,枚举值:1 :收费 0:不收费 |
data | Object | |
orderNo | String | 业务唯一流水号 |
handleTime | String | 查询时间。样例:2018-04-09 15:05:01 |
result | String | 认证结果。01:一致 02:不一致 03:认证不确定 04:认证失败。01、02收费 |
bankName | String | 银行卡所属银行。样例:招商银行 |
cardType | String | 银行卡类型 样例:金穗借记卡 |
cardCategory | String | 银行卡类别 样例:借记卡 |
remark | String | 备注。样例:信息认证未通过(验证不一致) |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/nrsh/detect_gif |
请求参数Body以x-www-form-urlencoded提交
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
appKey | 请在api.253.com登录后获取 |
image | 图像数据,base64编码。gif格式,每帧编码后大小< 4M,帧数不超过50,GIF图片整体大小base64编码后不超过20M |
响应body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录响应code码 |
message | String | 响应code码解释 |
data | Object | 识别结果。各具体字段: class_name,分类结果名称;probability,分类结果置信度 |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/nrsh/img_censor |
请求参数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:图像质量检测 |
响应body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录响应code码 |
message | String | 响应code码解释 |
data | Object | 识别结果。各具体字段:antiporn##result##class_name,分类标签名;antiporn##result##probability,分类标签置信度;antiporn##conclusion,分析结论;terror##result##name,分类标签名;terror##result##score,分类标签置信度;watermark##result_num,分析出的水印数量;disgust##result,是恶心图片的置信度;quality##clarity,图片清晰度;quality##aesthetic,图片美观度。 |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/txsb/chexing |
请求参数Body以x-www-form-urlencoded提交
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
appKey | 请在api.253.com登录后获取 |
top_num | 返回结果top n,默认5,该参数为可选 |
image | 图像文件内容进行base64之后的值 |
响应Body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见响应code码 |
message | String | 响应code码解释 |
data | Object | 识别结果。各字段说明:name,车辆的品牌型号信息;score,识别结果置信度。 |
https://www.253.com/#/data/product_main/12?productCateCode=3&productCateName=%E5%AE%9E%E5%90%8D%E8%AE%A4%E8%AF%81
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/idcard/id-card-auth |
请求参数Body以multipart/form-data方式提交
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
appKey | 请在api.253.com登录后获取 |
name | 姓名 |
idNum | 身份证号码 |
响应body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录5.1响应code码 |
message | String | 响应code码解释 |
data | Object | |
orderNo | String | 业务唯一流水号。例:628291418130630 |
handleTime | String | 查询时间 例:2018-04-09 15:05:01 |
province | String | 省份 |
city | String | 市区 |
country | String | 县区 |
birthday | String | 生日,格式是yyyyMMdd |
age | String | 年龄 |
gender | String | 性别:1:男、2:女 |
remark | String | 备注,例:一致 |
result | String | 返回结果: 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定(收费) 04-认证失败(不收费) |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/idcard/id-card-auth/vs |
请求参数Body以multipart/form-data方式提交
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
name | 姓名 |
idNum | 身份证号码 |
sign | 签名。按appId+idNum+name顺序,将参数名称和值拼接,例如"appIdAbcd1234idNum430512198908131367name代用名",之后以appKey(控制台获得)为密钥, 使用hmacSHA1签名后经Base64编码得到。 |
响应body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录5.1响应code码 |
message | String | 响应code码解释 |
data | Object | |
orderNo | String | 业务唯一流水号。例:628291418130630 |
handleTime | String | 查询时间 例:2018-04-09 15:05:01 |
province | String | 省份 |
city | String | 市区 |
country | String | 县区 |
birthday | String | 生日,格式是yyyyMMdd |
age | String | 年龄 |
gender | String | 性别:1:男、2:女 |
remark | String | 备注,例:一致 |
result | String | 返回结果: 01-认证一致(收费) 02-认证不一致(收费) 03-认证不确定(收费) 04-认证失败(不收费) |
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | https://api.253.com/open/carriers/carriers-auth |
请求参数Body以multipart/form-data方式提交
参数名 | 说明 |
---|---|
appId | 请在api.253.com登录后获取 |
appKey | 请在api.253.com登录后获取 |
name | 姓名 |
idNum | 身份证号码 |
mobile | 手机号码 |
响应body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
code | String | 响应code码。200000:成功,其他失败。见附录5.1响应code码 |
message | String | 响应code码解释 |
chargeStatus | String | 是否收费,枚举值:1 :收费 0:不收费 |
data | Object | |
orderNo | String | 业务唯一流水号。例:628291418130630 |
handleTime | String | 查询时间 例:2018-04-09 15:05:01 |
type | String | 运营商类型:1、中国移动2、中国联通3、中国电信 |
age | String | 年龄 |
gender | String | 性别:1:男、2:女 |
result | String | 认证结果,01-一致,02-不一致,03-不确定,04-失败 |
remark | String | 备注 ,例:一致 |
https://www.253.com/#/data/product_main/150
名称 | 说明 |
---|---|
协议 | HTTPS POST |
编码格式 | UTF8 |
返回类型 | application/json |
URL | api.253.com/open/kdwl/kdcx |
请求参数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 | 收件人手机号后四位,顺丰需要填写 |
响应body数据为JSON格式
字段名 | 类型 | 说明 |
---|---|---|
chargeStatus | Int | 是否收费:1收费,0不收费 |
code | String | 响应code码。200000:成功,其他失败。见附录响应code码 |
message | String | 响应code码解释 |
data | Object | 返回对象 |
showapi_res_id | string | data内参数:本次请求ID |
showapi_res_error | string | data内参数:错误信息的展示 |
showapi_res_code | int | data内参数:0,成功;-1,系统调用错误; -2,可调用次数或者金额为0 |
showapi_res_body | Object | data内参数:查询结果的封装 |
expTextName | string | showapi_res_body内参数:快递公司名称 |
expSpellName | string | showapi_res_body内参数:快递公司英文 |
mailNo | string | showapi_res_body内参数:快递单号 |
update | string | showapi_res_body内参数:更新时间(时间戳) |
tel | string | showapi_res_body内参数:联系电话 |
data | array | showapi_res_body内参数:快递动态 |
context | string | showapi_res_body内data数组元素内参数:快递最新动态 |
time | string | showapi_res_body内data数组元素内参数:最新动态对应时间 |
status | int | showapi_res_body内参数:快件签收状态。 -1 待查询 0 查询异常 1 暂无记录 2 在途中 3 派送中 4 已签收 5 用户拒签 6 疑难件 7 无效单 8 超时单 9 签收失败 10 退回 |
possibleExpList | array | showapi_res_body内参数: 在auto的情况下,返回可能的快递列表simpleName快递简称、 expName快递公司名 |
ret_code | int | showapi_res_body内参数:查询是否成功 |
dataSize | int | showapi_res_body内参数:快递节点数量 |
msg | string | showapi_res_body内参数:返回说明信息 |
updateStr | string | showapi_res_body内参数:更新时间 |
flag | string | showapi_res_body内参数:成功或者失败的标识 |
queryTimes | int | showapi_res_body内参数:当前快递单号每天查询总次数 |
**接口地址:**http://v.juhe.cn/vinParse/query.php
**返回格式:**json
**请求方式:**get post
请求示例:http://v.juhe.cn/vinParse/query.php?vin=LHGCP260*****&key=您申请的key
**接口备注:**根据VIN码准确定型,获取保险车辆列表(含配置信息) 包含:车型代码,唯一标识、车型名称、品牌名称、车系名称、车组名称、排量、发动机描述、发动机型号等等。
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
vin | 是 | string | 车架号 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 状态码 | |
reason | string | 状态描述 | |
result | array | 结果集 | |
questionList | array | 返回车型问题集合 | |
questionList说明 | |||
answerConent | String | 答案选项 | |
answerValue | String | 答案值 | |
question | String | 问题 | |
yesFlag | String | 答案选项 | |
vehicleList | array | 返回后市场车型列表 | |
vehicleList说明 | |||
brandName | String | 品牌名称 | |
groupCode | String | 车组编码 | |
groupName | String | 车组名称 | |
vehicleId | String | 车型代码,唯一标识 | |
vehicleName | String | 车型名称 | |
importFlag | String | 国产/进口 | |
standardName | String | 车型俗称 | |
displacement | String | 排量 | |
yearPattern | String | 年款 | |
uploadDate | String | 出厂日期 | |
standardname2 | String | 公告号 | |
purchasePrice | String | 新车购置价 | |
gearboxType | String | 变速箱类型 | |
supplyOil | String | 供油方式 | |
fuelJetType | String | 燃油喷射形式 | |
engineModel | String | 发动机型号 | |
drivenType | String | 驱动形式 | |
remark | String | 备注 | |
hasConfig | String | 是否有更多配置 | |
listPrice | String | 厂商指导价 | |
familyName | String | 车系名称 | |
seat | String | 座位数 | |
cfgLevel | String | 配置等级 | |
marketDate | String | 上市年份 | |
vehicleSize | String | 外形尺寸 | |
wheelbase | String | 轴距 | |
gearNum | String | 变速器档数 | |
fullWeight | String | 整备质量(千克) | |
power | String | 功率 | |
bodyType | String | 车身结构 | |
effluentStandard | String | 排放标准 | |
vehicleColor | String | 车身颜色 | |
vehlsSeri | String | 是否商用车(不一定有值) |
接口地址:http://v.juhe.cn/wzHistory/city.php
**返回格式:**json
**请求方式:**get post
**请求示例:**http://v.juhe.cn/wzHistory/city.php?key=你申请的key
**接口备注:**获取城市查询违章的参数规则,建议每天更新一次
[API测试工具](javascript:frameLogin(9))
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
prefix | 否 | string | 对应车牌前缀 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码(下面所有接口均有返回此字段,下面不再说明) | |
reason | string | 提示信息(下面所有接口均有返回此字段,下面不再说明) | |
result | string | 结果(下面所有接口均有返回此字段,下面不再说明) | |
prefix | string | 前缀 | |
vin | string | 车架号长度((最后几位)车架长度,0为全部信息,-1为无需提供,其他为所需提供的长度值) | |
engine_no | string | 发动机号长度((最后几位)车架长度,0为全部信息,-1为无需提供,其他为所需提供的长度值) | |
status | boolean | 是否支持查询(1为支持查询,0为暂不支持查询) |
**接口地址:**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))
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
carNo | 是 | string | 车牌号 | |
vin | 否 | string | 车架号(根据城市列表的规则决定长度) | |
engineNo | 否 | string | 发动机号(根据城市列表的规则决定长度) | |
type | 否 | string | 车类型(默认02:小型车,支持大小车查询) |
名称 | 类型 | 说明 | |
---|---|---|---|
wz_date | string | 违章时间 | |
area | string | 违章地址 | |
act | string | 违章行为 | |
wz_code | string | 违法行为代码 | |
fen | int | 扣分 | |
money | double | 罚款金额 | |
handled | int | 是否支持处理(1已处理,0未处理) | |
if_paid | int | 是否缴费(1已缴费,0未缴费) | |
wz_city | string | 违章城市 |
**接口地址:**http://v.juhe.cn/sweizhang/citys
**返回格式:**json/xml
**请求方式:**get post
**请求示例:**http://v.juhe.cn/sweizhang/citys?key=key
**接口备注:**有些城市如果维护,我们会临时下线处理
API测试工具
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
province | N | string | 默认全部,省份简写,如:ZJ、JS | |
dtype | N | string | 返回数据格式:json或xml,默认json | |
key | Y | string | 在个人中心->我的数据,接口名称上方查看 |
名称 | 类型 | 说明 | |
---|---|---|---|
province_code | String | 省份代码 | |
province | String | 省份名称 | |
citys | Array | 省份下开通城市数组 | |
city_code | String | 城市代码 | |
city_name | String | 城市名称 | |
engine | String | 是否需要发动机号0,不需要 1,需要 | |
engineno | String | 需要几位发动机号0,全部 1-9 ,需要发动机号后N位 | |
class | String | 是否需要车架号0,不需要 1,需要 | |
classa | String | 同上,(解决java中class关键字无法映射) | |
classno | String | 需要几位车架号0,全部 1-9 需要车架号后N位 |
**接口地址:**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))
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
dtype | 否 | string | 返回数据格式:json或xml,默认json | |
callback | 否 | String | 返回格式选择jsonp时,必须传递 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
city | 是 | String | (车牌所在地)城市代码 | |
hphm | 是 | String | 号牌号码 完整7位 ,需要utf8 urlencode* | |
hpzl | 否 | string | 号牌类型,默认02:小型车,01:大型车,52:新能源小型车,51:新能源大型车 | |
engineno | 否 | String | 发动机号 (具体是否需要根据城市接口中的参数填写) | |
classno | 否 | String | 车架号 (具体是否需要根据城市接口中的参数填写) |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 状态码 | |
province | String | 查询省份代码 | |
city | String | 查询城市代码 | |
hphm | String | 查询的号牌号码 | |
lists | Array | 违章列表 | |
date | String | 违章时间 | |
area | String | 违章地点 | |
archiveno | string | 文书编号(不一定获取到) | |
act | String | 违章行为 | |
code | String | 违章代码(仅供参考,不一定有值) | |
fen | String | 违章扣分(仅供参考,不一定有值) | |
money | String | 违章罚款(仅供参考,不一定有值) | |
handled | String | 是否处理,1处理 0未处理 空未知 | |
hpzl | string | 车牌类型(02小型车) | |
wzcity | string | 违章城市(仅供参考,不一定有值) | |
cjjg | string | 采集机关(不一定有值) |
**接口地址:**http://v.juhe.cn/sweizhang/carPre
**返回格式:**json
**请求方式:**get
**请求示例:**http://v.juhe.cn/sweizhang/carPre.php?key=&hphm=%E6%B2%AAC
**接口备注:**根据车牌前缀或车牌号码,获取对应的城市代码及违章查询条件参数
[API测试工具](javascript:frameLogin(9))
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | Y | string | 在个人中心->我的数据,接口名称上方查看 | |
hphm | 是 | String | 车牌前缀(前2位)或车牌号,如:浙A;需要utf8 urlencode | |
isNer | 否 | int | 是否新能源,默认为0,可选参数0:否,1:是 |
名称 | 类型 | 说明 | |
---|---|---|---|
province | String | 省份名称 | |
city_code | String | 城市代码 | |
city_name | String | 城市名称 | |
abbr | string | 车牌前缀 | |
engine | String | 是否需要发动机号,0:不需要 1:需要 | |
engineno | String | 需要几位发动机号0:全部 1-9 :需要发动机号后N位 | |
classa | String | 是否需要车架号,0:不需要 1:需要 | |
classno | String | 需要几位车架号0:全部 1-9: 需要车架号后N位 |
https://www.juhe.cn/docs/api/id/153
**接口地址:**http://v.juhe.cn/certificates/typeList.php
**返回格式:**json
**请求方式:**get/post
**请求示例:**http://v.juhe.cn/certificates/typeList.php?key=您申请的appkey
**接口备注:**查询支持的证件类型清单
[API测试工具](javascript:frameLogin(9))
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
{
"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":"营业执照"
}
}
**接口地址:**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))
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 您申请的appkey |
cardType | 是 | string | 证件类型,参考接口1 |
pic | 是 | MultipartFile | 上传图片,大小限制在3M以内(一般建议200k以下) |
userid | 否 | string | 用户单号 |
orderid | 否 | string | 传1表示需要返回聚合订单号,不输入或其他则不返回 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回说明 |
result | string | 返回结果集 |
**接口地址:**http://apis.juhe.cn/drivingLicenseOcr/index
**返回格式:**json
**请求方式:**http post
**请求示例:**http://apis.juhe.cn/drivingLicenseOcr/index
**接口备注:**对机动车驾驶证所有关键字段进行识别
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
image | 是 | string | 图片,base64编码,编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 。注意:图片需要base64编码、去掉编码头后再进行urlencode。 | |
detect_direction | 否 | int | 是否检测图像朝向,默认不检测;1:检测 0:不检测 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
**接口地址:**http://apis.juhe.cn/vehicleLicenseOcr/index
**返回格式:**json
**请求方式:**http post
**请求示例:**http://apis.juhe.cn/vehicleLicenseOcr/index
**接口备注:**对机动车行驶证主页字段进行结构化识别
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
image | 是 | string | 图片,base64编码,编码后大小不超过4M,最短边至少15px,最长边最大4096px,支持jpg/png/bmp格式 。注意:图片需要base64编码、去掉编码头后再进行urlencode。 | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
{
"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
}
https://www.juhe.cn/docs/api/id/103
**接口地址:**http://op.juhe.cn/idcard/query
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://op.juhe.cn/idcard/query?key=您申请的KEY&idcard=&realname=
**接口备注:**error_code为0或者210301时计费
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
idcard | 是 | string | 身份证号码 |
realname | 是 | string | 姓名 |
orderid | 否 | int | 传1时返回单号,默认不返回单号 |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回说明 |
result | object | 返回结果集 |
realname | string | 属result,真实姓名 |
idcard | string | 属result,身份证号 |
res | int | 属result,匹配详情,1匹配,2不匹配 |
JSON返回示例:
{
"reason": "成功",
"result": {
"realname": "***",/*真实姓名*/
"idcard": "******************",/*身份证号码*/
"res": 1 /*1:匹配 2:不匹配*/
},
"error_code": 0
}
**接口地址:**http://op.juhe.cn/idcard/verifys
**返回格式:**json
**请求方式:**get/post
**请求示例:**http://op.juhe.cn/idcard/verifys?key=您申请的KEY&idcard=&realname=
**接口备注:**error_code为0时计费
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
idcard | 是 | string | 身份证号码 | |
realname | 是 | string | 姓名(需utf8编码的urlencode) | |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
uorderid | 是 | string | 用户订单号(8-32位字母数字组合,需要唯一) | |
sign | 是 | string | md5(openid+appkey+idcard+realname+uorderid)32位小写,openid在个人中心查询 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | object | 返回结果集 | |
realname | string | 属result,真实姓名 | |
idcard | string | 属result,身份证号 | |
res | int | 属result,匹配详情,1匹配,2不匹配 | |
orderid | string | 属result,聚合订单号 |
{
"reason": "成功",
"result": {
"realname": "***",/*真实姓名*/
"idcard": "******************",/*身份证号码*/
"res": 1, /*1:匹配 2:不匹配*/
"orderid":"J103201712261751495244"/*聚合订单号*/
},
"error_code": 0
}
**接口地址:**http://op.juhe.cn/idcard/queryEncry
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://op.juhe.cn/idcard/queryEncry?key=您申请的KEY&idcard=&realname=
**接口备注:**error_code为0或者210301时计费
名称 | 必填 | 类型 |
---|---|---|
idcard | 是 | string |
realname | 是 | string |
key | 是 | string |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回说明 |
result | object | 返回结果集 |
res | int | 属result,匹配详情,1匹配,2不匹配 |
orderid | string | 属result,单号 |
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16位
{
"reason": "成功",
"result": {
"orderid":"J103201911121607589548",/*单号*/[/color]
"res": 1 /*1:匹配 2:不匹配*/
},
"error_code": 0
}
https://www.juhe.cn/docs/api/id/207
**接口地址:**http://v.juhe.cn/verifybankcard3/query
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://v.juhe.cn/verifybankcard3/query?key=&realname=&bankcard=&idcard=
**接口备注:**根据姓名+身份证号+银行卡卡号验证是否匹配
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
realname | 是 | string | 姓名 | |
idcard | 是 | string | 身份证号码 | |
bankcard | 是 | string | 银行卡卡号 | |
uorderid | 否 | string | 用户订单号,8到32位数字字母组合,要保证唯一 | |
isshow | 否 | int | 是否显示匹配信息,0默认不显示,1显示 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回码描述 | |
jobid | string | 本次查询流水号 | |
bankcard | string | 银行卡卡号 | |
realname | string | 姓名 | |
idcard | string | 身份证号码 | |
res | int | 匹配结果,1:匹配 2:不匹配 | |
message | string | 只有参数isshow不为空且不为0时显示 |
{
"reason": "成功",
"result": {
"jobid": "JH2071191112162139847181e7",
"bankcard": "*************",
"realname": "***",
"idcard": "***************",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 0
}
**接口地址:**http://v.juhe.cn/verifybankcard3/verify
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://v.juhe.cn/verifybankcard3/verify?key=&realname=&bankcard=&idcard=&sign=
**接口备注:**根据姓名+身份证号+银行卡卡号验证是否匹配
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名,需要utf8 Urlencode |
idcard | 是 | string | 身份证号码 |
bankcard | 是 | string | 银行卡卡号 |
uorderid | 否 | string | 用户订单号,不超过32位,要保证唯一 |
isshow | 否 | int | 是否显示匹配信息,0默认不显示,1显示 |
sign | 是 | string | md5(openid+appkey+bankcard+realname+idcard),openid在个人中心查询 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
jobid | string | 本次查询流水号 |
bankcard | string | 银行卡卡号 |
realname | string | 姓名 |
idcard | string | 身份证号码 |
res | int | 匹配结果,1:匹配 2:不匹配 |
message | string | 只有参数isshow不为空且不为0时显示 |
{
"reason": "成功",
"result": {
"jobid": "2017052515514933954",
"bankcard": "*****************",
"realname": "**",
"idcard": "*************",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 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))
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名 |
idcard | 是 | string | 身份证号码 |
bankcard | 是 | string | 银行卡卡号 |
idtype | 否 | string | 证件类型,具体见JSON示例。默认:01 |
uorderid | 否 | string | 用户订单号,8到32位数字字母组合,要保证唯一 |
isshow | 否 | int | 是否显示匹配信息,0默认不显示,1显示 |
code | 是 | string | 发起交易商户业务编码, 具体见JSON示例,如:01 |
customer | 是 | string | 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
jobid | string | 本次查询流水号 |
bankcard | string | 银行卡卡号 |
realname | string | 姓名 |
idcard | string | 身份证号码 |
res | int | 匹配结果,1:匹配 2:不匹配 |
message | string | 只有参数isshow不为空且不为0时显示 |
/**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
}
**接口地址:**http://v.juhe.cn/verifybankcard3/queryEncry
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://v.juhe.cn/verifybankcard3/queryEncry?key=&realname=&bankcard=&idcard=
**接口备注:**根据姓名+身份证号+银行卡卡号验证是否匹配
[API测试工具](javascript:frameLogin(9))
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
realname | 是 | string | 姓名加密 | |
idcard | 是 | string | 身份证号码加密 | |
bankcard | 是 | string | 银行卡卡号加密 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回码描述 | |
jobid | string | 本次查询流水号 | |
res | int | 匹配结果,1:匹配 2:不匹配 | |
message | string | 只有参数isshow不为空且不为0时显示 |
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16位
{
"reason": "成功",
"result": {
"jobid": "JH2071191112162139847181e7",
"res": 2,
"message": "认证信息不匹配,银行卡无效"
},
"error_code": 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=
**接口备注:**根据姓名、身份证、银行卡、商户名称、场景检测信息是否匹配
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名加密 |
idcard | 是 | string | 身份证号码加密 |
bankcard | 是 | string | 银行卡卡号加密 |
idtype | 否 | string | 证件类型,具体见JSON示例。默认:01 |
code | 是 | string | 发起交易商户业务编码, 具体见JSON示例,如:01 |
customer | 是 | string | 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
jobid | string | 本次查询流水号 |
res | int | 匹配结果,1:匹配 2:不匹配 |
message | string | 只有参数isshow不为空且不为0时显示 |
/**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
}
https://www.juhe.cn/docs/api/id/213
**接口地址:**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=
**接口备注:**根据姓名、身份证、银行卡、手机号码、商户名称、场景检测信息是否匹配
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名加密 |
idcard | 是 | string | 身份证号码加密 |
bankcard | 是 | string | 银行卡卡号加密 |
mobile | 是 | string | 手机号码加密 |
code | 是 | string | 发起交易商户业务编码, 具体见JSON示例,如:01 |
customer | 是 | string | 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户; |
idtype | 否 | string | 证件类型,具体见JSON示例。默认:01 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
res | string | 匹配结果,1:匹配 2:不匹配 |
jobid | string | 本次查询流水号 |
/**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
}
**接口地址:**http://v.juhe.cn/verifybankcard4/verify
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://v.juhe.cn/verifybankcard4/verify?key=&realname=&idcard=&bankcard=&mobile=&sign=
**接口备注:**根据姓名、身份证、银行卡、手机号码,检测信息是否匹配
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
realname | 是 | string | 姓名 | |
idcard | 是 | string | 身份证号码 | |
bankcard | 是 | string | 银行卡卡号 | |
mobile | 是 | string | 手机号码 | |
uorderid | 否 | string | 用户订单号,不超过32位,要保证唯一 | |
sign | 是 | string | md5(openid+appkey+bankcard+realname+idcard+mobile),openid在个人中心查询 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回码描述 | |
bankcard | string | 银行卡卡号 | |
realname | string | 姓名 | |
idcard | string | 身份证号码 | |
res | string | 匹配结果,1:匹配 2:不匹配 | |
jobid | string | 本次查询流水号 | |
mobile | string | 手机号码 |
{
"reason": "成功",
"result": {
"jobid": "2015120913503797592",/*本次查询流水号*/
"realname": "***",/*姓名*/
"bankcard": "***************",/*银行卡卡号*/
"idcard": "*******************",/*身份证号码*/
"mobile": "********",/*预留手机号码*/
"res": "2",/*验证结果,1:匹配 2:不匹配*/
"message": "认证信息不匹配"/*描述*/
},
"error_code": 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=
**接口备注:**根据姓名、身份证、银行卡、手机号码、商户名称、场景检测信息是否匹配
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名 |
idcard | 是 | string | 身份证号码 |
bankcard | 是 | string | 银行卡卡号 |
mobile | 是 | string | 手机号码 |
code | 是 | string | 发起交易商户业务编码, 具体见JSON示例,如:01 |
customer | 是 | string | 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户; |
idtype | 否 | string | 证件类型,具体见JSON示例。默认:01 |
uorderid | 否 | string | 用户订单号,不超过32位,要保证唯一 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
bankcard | string | 银行卡卡号 |
realname | string | 姓名 |
idcard | string | 身份证号码 |
res | string | 匹配结果,1:匹配 2:不匹配 |
jobid | string | 本次查询流水号 |
mobile | string | 手机号码 |
/**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
}
**接口地址:**http://v.juhe.cn/verifybankcard4/queryEncry
**返回格式:**json
**请求方式:**get/post
**请求示例:**http://v.juhe.cn/verifybankcard4/queryEncry?key=&bankcard=&realname=&idcard=&mobile=
**接口备注:**根据姓名、身份证、银行卡、手机号码,检测信息是否匹配
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名加密 |
idcard | 是 | string | 身份证号码加密 |
bankcard | 是 | string | 银行卡卡号加密 |
mobile | 是 | string | 手机号码加密 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
res | string | 匹配结果,1:匹配 2:不匹配 |
jobid | string | 本次查询流水号 |
加密算法:AES/ECB/PKCS5Padding,AES结果无需转小写,经过base64
加密后的数据需要urlencode传入
加密的密钥为:客户个人中心的openid经过md5后结果为小写取前16位
{
"reason": "成功",
"result": {
"jobid": "JH2131191113105116991630Np",/*本次查询流水号*/
"res": "2",/*验证结果,1:匹配 2:不匹配*/
"message": "认证信息不匹配"/*描述*/
},
"error_code": 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=
**接口备注:**根据姓名、身份证、银行卡、手机号码、商户名称、场景检测信息是否匹配
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
realname | 是 | string | 姓名加密 |
idcard | 是 | string | 身份证号码加密 |
bankcard | 是 | string | 银行卡卡号加密 |
mobile | 是 | string | 手机号码加密 |
code | 是 | string | 发起交易商户业务编码, 具体见JSON示例,如:01 |
customer | 是 | string | 公司名+产品名称+具体使用该服务的步骤。如:**有限公司+**APP/**产品+注册开户; |
idtype | 否 | string | 证件类型,具体见JSON示例。默认:01 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回码描述 |
res | string | 匹配结果,1:匹配 2:不匹配 |
jobid | string | 本次查询流水号 |
/**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
}
https://www.juhe.cn/docs/api/id/43
**接口地址:**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
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
com | 是 | string | 需要查询的快递公司编号 |
no | 是 | string | 需要查询的快递单号 |
senderPhone | 否 | int | 寄件人手机号后四位,顺丰快递需要提供senderPhone和receiverPhone其中一个 |
receiverPhone | 否 | int | 收件人手机号后四位,顺丰快递需要提供senderPhone和receiverPhone其中一个 |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
dtype | 否 | string | 返回数据的格式,xml或json,默认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表示查询正常,其他表示查询不到物流信息或发生了其他错误 */
}
**接口地址:**http://v.juhe.cn/exp/com
**返回格式:**json/xml/jsonp
**请求方式:**http post get
**请求示例:**http://v.juhe.cn/exp/com?key=key
/* 以下快递公司列表仅作为格式上的说明,实际支持的列表以接口实时返回的数据为准 */
{
"resultcode": "200",
"reason": "查询支持的快递公司成功",
"result": [
{
"com": "顺丰",
"no": "sf"
},
{
"com": "申通",
"no": "sto"
},
{
"com": "圆通",
"no": "yt"
},
{
"com": "韵达",
"no": "yd"
},
{
"com": "天天",
"no": "tt"
}
......有省略
],
"error_code": 0
}
**接口地址:**http://op.juhe.cn/ofpay/sinopec/onlineorder
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://op.juhe.cn/ofpay/sinopec/onlineorder
接口备注:正式使用后建议个人中心绑定IP白名单。加油卡完成网上充值后,需到所充值油卡当地加油站请工作人员进行激活(圈存)操作,否则充值金额将无法生效。发票等相关问题请联系客服。 如果充值过程中,遇到http网络状态异常或返回系统异常,请务必通过订单查询接口检测订单或联系客服,不要直接做失败处理,避免造成不必要的损失!!!**
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
proid | 是 | int | 产品id: 10000(中石化50元加油卡)[暂不支持] 10001(中石化100元加油卡) 10002(中石化200元加油卡) 10003(中石化500元加油卡) 10004(中石化1000元加油卡) 10007(中石化任意金额充值)[暂不支持] 10008(中石油任意金额充值)) |
cardnum | 是 | string | 充值数量(产品id为10007、10008时为具体充值金额(整数),其余产品id请传固定值1);注:中石油任意冲(产品id:10008)暂时只支持100\200\500\1000 |
orderid | 是 | string | 商家订单号,8-32位字母数字组合 |
game_userid | 是 | string | 加油卡卡号,中石化:以100011开头的19位卡号、中石油:以90开头的16位卡号 |
gasCardTel | 是 | string | 持卡人手机号码,可以填写一个固定格式的手机号码,如:18900000000;为了保证充值质量,中石油充值请传递加油卡账号的绑卡手机号。 |
gasCardName | 否 | string | 持卡人姓名 |
chargeType | 否 | int | 加油卡类型 (1:中石化、2:中石油;默认为1) |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
sign | 是 | string | 校验值,md5(OpenID+key+proid+cardnum+game_userid+orderid),OpenID在个人中心查询。加密结果转为32位小写 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回说明 |
result | string | 返回结果集 |
{
"reason": "提交充值成功",
"result": {
"cardnum": "1", /*充值数量*/
"ordercash": "100", /*售价*/
"cardname": "全国加油卡", /*充值名称*/
"sporder_id": "S20141125221812330", /*商家订单号*/
"game_userid": "100011320000991****", /*加油卡卡号*/
"game_state": "0", /*充值状态:0充值中 1成功 9撤销,刚提交成功的单子状态均为充值中*/
"uorderid": "S2014111111115" /*商户自定的订单号*/
},
"error_code": 0
}
**接口地址:**http://op.juhe.cn/ofpay/sinopec/ordersta
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://op.juhe.cn/ofpay/sinopec/ordersta?key=&orderid=S2014111111115
**接口备注:**根据用户的订单号查询状态,本接口暂只支持查询近60天订单,请务必确认订单已经成功提交后再查询,避免造成不必要的损失;如果查询过程中,遇到http网络状态异常或错误码返回系统异常10014,或联系客服,不要直接做失败处理,避免造成不必要的损失!!!
名称 | 必填 | 类型 | 说明 |
---|---|---|---|
orderid | 是 | string | 商家订单号,8-32位字母数字组合 |
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 |
名称 | 类型 | 说明 |
---|---|---|
error_code | int | 返回码 |
reason | string | 返回说明 |
result | string | 返回结果集 |
{
"reason": "查询成功",
"result": {
"cardname": "全国 中石化加油 固定面值加油卡 直充100元",/*商品名称*/
"game_userid": "1000119000002494353",/*加油卡卡号*/
"uordercash": "100.000",/*订单消耗金额*/
"sporder_id": "S17070400085272603302001",/*聚合订单号*/
"game_state": "9",/*状态 1:成功 9:失败 0:充值中*/
"err_msg": "只能给主卡且卡状态正常的加油卡充值"/*描述,订单失败时返回失败原因*/
},
"error_code": 0
}
**接口地址:**您接收回调新的URL地址,联系客服配置
**返回格式:**接收到回调,请返回任意字符串
**请求方式:**http post
请求示例:
API测试工具
请求参数说明:
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
聚合推送参数 | - | - | - | |
sporder_id | string | Y | 聚合订单号 | |
orderid | string | Y | 用户自定义的单号 | |
sta | int | Y | 充值状态1:成功 9:失败 | |
sign | string | Y | 校验值,md5(appkey+sporder_id+orderid) 32位小写,用于校验请求合法性 | |
err_msg | string | N | 状态描述信息(暂只支持油卡业务) |
返回参数说明:
名称 | 类型 | 说明 | |
---|---|---|---|
JSON返回示例:
只有成功提交的订单才会有回调通知,如果提交订单是直接返回错误码,这部分单子不会发起回调通知。
详细说明可参考:http://code.juhe.cn/docs/detail/id/1565
处理成功请返回:success 或 任意字符串
重试机制:聚合数据在请求回调地址时,如果无任何内容返回或无响应,会重新发起最多3次,间隔3s左右
本回调推送内容格式适用于话费充值、油卡充值、流量充值等增值服务
如果需要状态回调的用户,如接口其他已经调试完毕,请将账号和回调地址发给在线客服,我们将回调地址配置线上。
**接口地址:**http://op.juhe.cn/ofpay/sinopec/sordersta
**返回格式:**json
**请求方式:**http get/post
**请求示例:**http://op.juhe.cn/ofpay/sinopec/sordersta
**接口备注:**签名校验版,根据用户的订单号查询状态,本接口暂只支持查询近60天订单,根据用户的订单号查询状态,请务必确认订单已经成功提交后再查询,避免造成不必要的损失;如果查询过程中,遇到http网络状态异常或错误码返回系统异常10014,或联系客服,不要直接做失败处理,避免造成不必要的损失
名称 | 必填 | 类型 | 说明 | |
---|---|---|---|---|
key | 是 | string | 在个人中心->我的数据,接口名称上方查看 | |
orderid | 是 | string | 商家订单号,8-32位字母数字组合 | |
timestamp | 是 | string | 当前时间戳或随机数,如:1462502925 | |
sign | 是 | string | 校验值,md5(OpenID+key+orderid+timestamp),OpenID在个人中心查询 |
名称 | 类型 | 说明 | |
---|---|---|---|
error_code | int | 返回码 | |
reason | string | 返回说明 | |
result | string | 返回结果集 |
{
"reason": "查询成功",
"result": {
"cardname": "全国 中石化加油 固定面值加油卡 直充100元",/*商品名称*/
"game_userid": "1000119000002494353",/*加油卡卡号*/
"uordercash": "100.000",/*订单消耗金额*/
"sporder_id": "S17070400085272603302001",/*聚合订单号*/
"game_state": "9",/*状态 1:成功 9:失败 0:充值中*/
"err_msg": "只能给主卡且卡状态正常的加油卡充值"/*描述,订单失败时返回失败原因*/
},
"error_code": 0
}