wiki:pcautofinance1.0_developers/interfaces

Context Navigation

Version 131 (modified by caozhaoyuan, 11 years ago) (diff)
--

汽车金融WAP1.0接口文档

项目说明：

项目域名(wap)： http://m.jr.pcauto.com.cn
后端环境:

线上域名： http://jr.pcauto.com.cn
开发环境域名： http://dev43.pcauto.com.cn:8001

mrobot代理环境说明：

192.168.10.198:1080(192.168.74.80)
192.168.10.199:1080 ，连的是dev40的开发环境（192.168.75.40）

WAP端接口

1. 二维码接口(微信)

(wap开发中)
url： http://m.jr.pcauto.com.cn/api/qrcode?phoneId=2212121
后端接口(微信)： https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=

说明

返回带参数二维码图片的url地址

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
phoneId	电话号码	long		Y

返回数据

{
    "code": 200,
    "desc": "success",
    "url": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQH98DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL1VuV3lMVy1sc1ViSUdMNWNVRnZjAAIEBJ32VQMEgDoJAA%3D%3D"
}

返回参数说明

参数名	参数含义
data	二维码URL

PC端接口

1. 用户信息上传接口(微信)

(pc端开发中)
pc接口： http://

说明

上传微信用户信息到pc端

调用方式

post

请求参数

参数名	参数含义	类型	默认值	是否必需	说明

返回数据

{
   "code":200,
   "desc":"成功"
}

返回参数说明

参数名	参数含义

2. 车贷订单查询接口(微信)

(pc端开发中)
pc接口： http://

说明

按手机号/订单号查询用户订单详情

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
orderId	订单id	long	0	是	无

返回数据

{
   "code":200,
   "desc":"成功",
   "data":"datajson"
}

返回参数说明

参数名	参数含义

3. 热门车型推荐接口(WAP)

(pc端开发中)
pc接口： http://dev43.pcauto.com.cn:8001/interface/outer/mobile/hotModel.jsp?rId=1

原型

点击前往

说明

查询指定城市下的热门车型推荐数据，用于金融首页页面。

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
rid	城市id	int	待定	是	无

返回数据

{
    "list": [
        {
            "tab": "小型车",
            "data": [
                {
                    "icon":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1312/20/c36/29831872_1387528510250_100X75.jpg",
                    "serialGroupId": 4123,
                    "modelid": 58724,
                    "name": "卡罗拉",
                    "payment": 2415,
                    "cost": 7000
                }
            ]
        },
        {
            "tab": "紧凑型车",
            "data": [
                {
                    "icon":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1312/20/c36/29831872_1387528510250_100X75.jpg",
                    "serialGroupId": 4123,
                    "modelid": 58724,
                    "name": "卡罗拉",
                    "payment": 2415,
                    "cost": 7000
                }
            ]
        }
    ]
}

返回参数说明

参数名	参数含义
list	数组，包含4个数据对象
tab	标签名称
data	标签下的车型数据数组
serialGroupId	车系id
modelid	车型id
name	车系名
payment	月供
cost	贷款成本
icon	车系图片url

4. 热门贷款方案接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

查询指定城市下的热门贷款方案数据，用于金融首页页面。

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
rid	城市id	int	待定	是	无

返回数据

{
    "list": [
        {
            "tab": "推荐金融",
            "orgs": [
                {
                    "orgId": 1001,
                    "orgName": "招商银行",
                    "icon": "http://logo.png",
                    "prodId": 2001,
                    "prodName": "车易购",
                    "models": [
                        {
                          "cost": 0,
                          "modelId": 32603,
                          "name": "雷凌",
                          "payment": 0,
                          "prepay": "30%",
                          "serialGroupId": "10801",
                          "term": 24
                        }
                    ]
                }
            ]
        },
        {
            "tab": "超低利率",
            "data": [
                {}
            ]
        }
    ]
}

返回参数说明

参数名	参数含义
list	数组，包含4个数据对象
tab	标签名称
orgs	标签下的金融机构数据数组
orgId	机构id
orgName	机构名称
icon	机构图片url
prodId	产品id
prodName	产品名称
serialGroupId	车系id
modelid	车型id
name	车系名
payment	月供
name	车系名
prepay	首付比例
term	期限

5. 有贴息产品品牌列表接口(WAP)

(pc端开发中)

原型

点击前往

说明

返回有贴息产品的品牌列表数据，用于品牌厂商车系页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明

返回数据

{
    "list": [
    {
            "brands": [
                {
                    "id": "693",
                    "letter": "A",
                    "icon": "http://img0.png",
                    "name": "AC宝马"，
                    "isHot": 0
                },
                {
                    "id": "1",
                    "letter": "B",
                    "logo": "http://img2.png",
                    "name": "奥迪"，
                    "isHot": 0
                }
            ],
            "index": "A",
           
            "rowNum": 4
        },
        {
            "brands": [
                {
                    "id": "693",
                    "letter": "A",
                    "icon": "http://img0.png",
                    "name": "AC宝马"，
                    "isHot": 0
                },
                {
                    "id": "1",
                    "letter": "A",
                    "icon": "http://img2.png",
                    "name": "奥迪"，
                    "isHot": 0
                }
            ],
            "index": "A",
            "rowNum": 4
        }
    ]
}

返回参数说明

参数名	参数含义
list	品牌字母分组
brands	品牌对象数组
id	品牌id
name	品牌名
icon	品牌图片url
letter	品牌归属字母
index	字母
rowNum	字母品牌数
isHot	是否热门品牌，1是，0不是

6. 完整品牌列表接口(WAP)

(pc端开发中)

原型

点击前往

说明

返回完整的品牌列表数据，用于品牌厂商车系页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明

返回数据

{
    "list": [
{
            
        {
            "brands": [
                {
                    "id": "693",
                    "letter": "A",
                    "logo": "http://img0.png",
                    "name": "AC宝马"，
                    "isHot": 0
                },
                {
                    "id": "1",
                    "letter": "A",
                    "logo": "http://img2.png",
                    "name": "奥迪"，
                    "isHot": 0
                }
            ],
            "index": "A",
            "rowNum": 4
        }
    ]
}

返回参数说明

参数名	参数含义
list	品牌字母分组
brands	品牌对象数组
id	品牌id
name	品牌名
icon	品牌图片url
letter	品牌归属字母
index	字母
rowNum	字母品牌数

7. top200品牌列表接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

返回汽车网top200的品牌列表数据，用于按预算选车品牌页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
无	-	-	-	-	-

返回数据

{
    "list": [

        {
            "brands": [
                {
                    "id": "693",
                    "letter": "A",
                    "logo": "http://img0.png",
                    "name": "AC宝马"，
                    "isHot": 0
                },
                {
                    "id": "1",
                    "letter": "A",
                    "logo": "http://img2.png",
                    "name": "奥迪"，
                    "isHot": 0
                }
            ],
            "index": "A",
            "rowNum": 4
        }
    ]
}

返回参数说明

参数名	参数含义
list	品牌字母分组
brands	品牌对象数组
id	品牌id
name	品牌名
icon	品牌图片url
letter	品牌归属字母
index	字母
rowNum	字母品牌数

8. 有贴息产品厂商车系接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

按品牌id查询有贴息产品的厂商车系数据，用于品牌厂商车系页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
bid	品牌id	int	无	是
type	类型	string	discount	否

返回数据

{
    "list": [
        {
            "manufacturer": "上海大众",
            "serials": [
                {
                    "id": 1421,
                    "name": "朗逸",
                    "show": "0"//show字段，是Mrobot自己逻辑上添加，用于显示致灰及不致灰。 0表示致灰，1表示可点击。
                },
                {}
            ]
        },
        {
            "manufacturer": "一汽大众"
        }
    ]
}

返回参数说明

参数名	参数含义
list	厂商数组
manufacturer	厂商名称
serials	车系数组
id	车系id
name	车系名
hasDisProd	是否有贴息产品

9. 完整的厂商车系接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

按品牌id查询完整的厂商车系数据，用于品牌厂商车系页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
bid	品牌id	int	无	是
type	类型	string	default	否

返回数据

{
    "list": [
        {
            "manufacturer": "上海大众",
            "serials": [
                {
                    "id": 1421,
                    "name": "朗逸"，
                    "show": "0"//show字段，是Mrobot自己逻辑上添加，用于显示致灰及不致灰。 0表示致灰，1表示可点击。
                },
                {}
            ]
        },
        {
            "manufacturer": "一汽大众"
        }
    ]
}

返回参数说明

参数名	参数含义
list	厂商数组
manufacturer	厂商名称
serials	车系数组
id	车系id
name	车系名

10. 金融产品列表接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

查询金融产品列表数据

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
sort	排序类型	string	default	否	默认(default)、贷款成本(cost)、月供(payment)
feature	产品特点	int	0	否	默认(0)、贴息(待定)
prepay	首付比例	int	30	否	20%、30%、40%、50%、60%
term	期限	int	24	是	12、18、24、36
rid	城市id	int	0	是
serialId	车系id	int	无	否
modelId	车型id	int	无	否
pageSize	每页数量	int	6	否	默认值以需求为准
pageNo	页码	int	1	否

返回数据

{
    "serialId": 5124,
    "modelId": 63512,
    "name": "福特福克斯三厢",
    "firstPay": 2415,
    "loanAmount": 0.7,
    "price": 9.7,
    "icon": "http://logo.png",
    "list": [
        {
            "orgName": "招商银行",
            "icon": "http://logo.png",
            "products": [
                {
                    "id": 1001,
                    "name": "平安直通薪金贷",
                    "payment": 2419,
                    "cost": 0.7
                }
            ]
        }
    ],
    "total": 12,
    "pageNo": 1,
    "pageSize": 6
}

返回参数说明

参数名	参数含义
serialid	车系id
modelid	车型id
name	车型名
firstPay	首付
loanAmount	贷款金额
price	经销商平均报价
icon	车型图片url
list	金融机构数组
orgName	机构名称
icon	机构图标url
products	机构下产品数组
id	产品id
name	产品名称
payment	月供
cost	贷款成本
total	金融机构总数
pageNo	当期页码
pageSize	每页数量

11. 金融列表/详情页经销商接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

提供经销商列表数据，用于金融产品列表/详情页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
rid	城市id	int	无	是	待定
modelId	车型id	int	无	否

返回数据

{
    "isShowRZicon": 1,
    "vip": 1,
    "dealerId": 1234,
    "phone": "400-123-1234",
    "isShow24Icon": 1,
    "areaName": "",
    "range": 3,
    "phoneType": 1,
    "address": "广州天河XXX",
    "name": "广州中升之星",
    "agent": "4S店"
}

返回参数说明

参数名	参数含义
dealerId	经销商id
phone	电话
phoneType	电话类型
address	经销商地址
name	经销商名称
agent	级别

12. 用户询价提交接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

提交用户询价请求

调用方式

post

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
param	json数据	string	无	是	待定

param

{
   待定
}

返回数据

{
    "code": 0,
    "msg":"询价成功" 
}

返回参数说明

参数名	参数含义
code	返回码：成功(0)、失败(1)
msg	描述信息

13. 车型列表接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

查询车系下的车型数据

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
serialId	车系id	int	无	是

返回数据

{
    "name": "朗逸",
    "list": [
        {
            "year": "2015款",
            "data": [
                {
                    "id": "32059",
                    "title": "2015款 30 TFSI 标准型",
                    "price": "24.98"
                },
                {
                    "id": "32060",
                    "title": "1.6L标准型",
                    "price": "24.98"
                }
            ]
        },
        {
            "year": "2014款",
            "data": []
        }
    ]
}

返回参数说明

参数名	参数含义
name	车系名
list	年款车型数组
year	年款
data	车型数组
id	车型id
title	车型名
price	价格

14. 金融产品详情接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

查询金融产品详细信息

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需
productId	产品id	int	无	是
rid	城市id	int	无	是
modelId	车型id	int	无	是

返回数据

{
    "serialId": 5124,
    "modelId": 63512,
    "name": "福特福克斯三厢",
    "payment": "30-40",
    "cost": 0.7,
    "price": 9.7,
    "icon": "http://logo.png",
    "orgId": 1001,
    "orgName": "招商银行",
    "productId": 1001,
    "productName": "平安直通薪金贷",
    "feature": [0,1,2],
    "prepay": [30,40],
    "term": [12,18,24],
    "requirement": {
        "age": "25-55周岁",
        "target": "公积金缴存人群"
    },
    "introduce": {
        "downpayment": "30",
        "advantage": "····"
    }
}

返回参数说明

参数名	参数含义
serialid	车系id
modelid	车型id
name	车型名
payment	月供
cost	贷款成本
price	经销商平均报价
icon	车型图片url
ordId	机构id
orgName	机构名
productId	产品id
productName	产品名称
feature	特点数组，包含产品拥有的特点，如贴息
prepay	可选首付数组
term	可选期限数组
requirement	申请条件json对象
introduce	详细介绍json对象

15. 按预算选车型接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

按条件查询车型列表数据

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
rid	城市id	int	无	是
level	级别	int	无	否	级别参数待定
bid	品牌id	int	无	否	默认为空
prePayRange	首付范围	string	无	否	范围参数待定
paymentRange	月供范围	string	无	否	范围参数待定
sort	排序	string	default	否	默认(default)、月供(payment)
pageSize	每页数量	int	6	否	每页数量按需求
pageNo	当前页码	int	1	否

返回数据

{
    "list": [
        {
            "serialId": 5124,
            "modelId": 63512,
            "name": "福特福克斯三厢",
            "icon": "http://logo.png",
            "payment": 2415,
            "price": 24.5,
            "cost": 0.7
        },
        {
            "serialId": 5124,
            "modelId": 63512,
            "name": "福特福克斯三厢",
            "icon": "http://logo.png",
            "payment": 2415,
            "price": 24.5,
            "cost": 0.7
        }
    ],
    "total": 12,
    "pageNo": 1,
    "pageSize": 6
}

返回参数说明

参数名	参数含义
serialid	车系id
modelid	车型id
name	车系名
icon	车系图片url
price	官方价
payment	月供
cost	贷款成本
total	车型总数
pageNo	当前页码
pageSize	每页数量

16. 匹配金融产品查询接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

提交用户选择的金融产品和个人资质信息，查询匹配的金融产品数据

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
rid	城市id	int	无	是
productId	产品id	int	无	否	如无产品id则只有推荐金融数据
modelId	车型id	int	无	是
age	年龄范围id	int	无	是	范围id待定
education	学历id	int	无	是	学历id待定
marriage	婚姻状况	int	无	是	参数待定
house	购车地住房情况	int	无	是	参数待定
work	工作信息	int	无	是	参数待定
credit	信用情况	int	无	是	参数待定
income	税后年收入	int	无	是

返回数据

{
    "loan": "500000",
    "proportion": 30,
    "payment": 21.34,
    "price":80.23,
    "model": {
        "modelId": 23124,
        "modelName": "大众",
        "title": "速腾2015款"
    },
    "product": {
        "orgId": 1001,
        "icon": "http: //ccb.png",
        "orgName": "招商银行",
        "productId": 2005,
        "productName": "平安直通薪金贷",
        "payment": 2419,
        "cost": "0.7"
    },
    "ratio": 50,
    "above": [
        {
            "name": "身份证",
            "icon": "http://logo.png"
        }
    ],
    "below": [
        {
            "name": "身份证",
            "icon": "http://logo.png"
        }
    ]
}

返回参数说明

参数名	参数含义
loan	预计可贷款金额，元
proportion	最低首付比例
payment	最低首付
price	裸车价格
model	车型信息json
modelId	车型id
name	车系名
title	车型名
product	产品信息json
orgId	机构id
icon	机构图标
orgName	机构名
productId	产品id
productName	产品名
payment	月供
cost	贷款成本
ratio	首付比例，后台材料
above	高于首付需要的材料
below	低于首付需要的材料
name	材料名称
icon	材料图片url

17. 推荐经销商接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

提供推荐的经销商列表数据，用于匹配/推荐金融产品页面

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
rid	城市id	int	无	是	待定
serialId	车系id	int	无	是
modelId	车型id	int	无	否

返回数据

{"list":
   [{
    "isShowRZicon": 1,
    "vip": 1,
    "dealerId": 1234,
    "phone": "400-123-1234",
    "isShow24Icon": 1,
    "areaName": "",
    "range": 3,
    "phoneType": 1,
    "address": "广州天河XXX",
    "name": "广州中升之星",
    "agent": "4S店"
  }]
 }

返回参数说明

参数名	参数含义
dealerId	经销商id
phone	电话
phoneType	电话类型
address	经销商地址
name	经销商名称
agent	级别

18. 城市数据接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

提供城市字母/热门城市数据接口，用于更换/选择城市页

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
待定	-	-	-	-	-

返回数据

待定

返回参数说明

参数名	参数含义
待定	-

19. 贷款申请提交接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

提交用户的贷款申请信息

调用方式

post

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
data	申请数据json	string	无	是	-

data数据

待定

返回数据

{
    "code": 0,
    "msg":"提交成功",
    "id"："5131512315"
}

返回参数说明

参数名	参数含义
code	返回码，成功(0)，失败(1)
msg	返回码描述信息
id	手机or订单号，待定

20. 我的订单接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

按手机号查询用户订单信息

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
tel	手机号	long	无	是	-

返回数据

{
    "list": [
        {
            "id": 1025401294,
            "name": "哈佛H6 2015款",
            "city": "广州",
            "date": "2015-06-02",
            "contact": "神烦小猫咪",
            "tel": 13800138000,
            "product": {
                "icon": "http: //ccb.png",
                "orgName": "招商银行",
                "productName": "平安直通薪金贷",
                "payment": 2419,
                "cost": "0.7"
            },
            "dealers": [
                {
                    "agent": "4S店",
                    "name": "广州安捷鑫众",
                    "address": "广州市天河区"
                },
                {
                    "agent": "4S店"
                }
            ],
            "infos": [
                {
                    "text": "24-29岁",
                    "icon": "http://logo.png"
                },
                {
                    "text": "本科",
                    "icon": "http://logo.png"
                }
            ]
        }
    ]
}

返回参数说明

参数名	参数含义
list	订单信息数组
id	订单id
name	意向车型名
name	意向车型名
city	城市
date	申请日期
contact	联系人名称
tel	联系人手机
product	产品信息json
icon	结构图片
orgName	结构名称
productName	产品名称
payment	月供
cost	贷款成本
dealers	经销商信息
agent	经销商级别
name	经销商名称
address	经销商地址
infos	订单个人资质信息
text	个人资质描述
icon	个人资质图标

21. 发送验证码申请接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

发起向用户手机发送验证码的申请

调用方式

post

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
tel	手机号	long	无	是	-

返回数据

{
    "code": 0,
    "msg":"发起成功"
}

返回参数说明

参数名	参数含义
code	返回码，成功(0)，失败(1)
msg	返回码描述信息

22. 核对验证码接口(WAP)

(pc端开发中)
pc接口： http://

原型

点击前往

说明

核对用户收取到的验证码是否与手机号一致

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
idenCode	验证码	int	无	是	-

返回数据

{
    "code": 0,
    "msg":"验证成功"
}

返回参数说明

参数名	参数含义
code	返回码，成功(0)，失败(1)
msg	返回码描述信息

23. 金融列表数据字典接口(WAP)

(pc端开发中)
pc接口： http://

原型

无

说明

提供城市-车系-金融产品数据接口，缓存数据用于减轻后端接口的调用压力

调用方式

get

请求参数

参数名	参数含义	类型	默认值	是否必需	说明
无	-	-	-	-	-

返回数据

{
    "code": 0,
    "msg":"验证成功"
}

返回参数说明

参数名	参数含义
code	返回码，成功(0)，失败(1)
msg	返回码描述信息

Attachments

汽车金融个人资质字典ID.xls (12.5 KB) - added by wuxiaoling 11 years ago. 资质页文本与值相应关系表
报价库询价接口.txt (4.3 KB) - added by wuxiaoling 10 years ago.
申请材料详情.xls (11.0 KB) - added by wuxiaoling 10 years ago.
汽车金融WAP接口文档v1.22.doc (504.8 KB) - added by wuxiaoling 10 years ago.

Download in other formats:

Plain Text

Context Navigation

Table of Contents

汽车金融WAP1.0接口文档

WAP端接口

1. 二维码接口(微信)

PC端接口

1. 用户信息上传接口(微信)

2. 车贷订单查询接口(微信)

3. 热门车型推荐接口(WAP)

4. 热门贷款方案接口(WAP)

5. 有贴息产品品牌列表接口(WAP)

6. 完整品牌列表接口(WAP)

7. top200品牌列表接口(WAP)

8. 有贴息产品厂商车系接口(WAP)

9. 完整的厂商车系接口(WAP)

10. 金融产品列表接口(WAP)

11. 金融列表/详情页经销商接口(WAP)

12. 用户询价提交接口(WAP)

13. 车型列表接口(WAP)

14. 金融产品详情接口(WAP)

15. 按预算选车型接口(WAP)

16. 匹配金融产品查询接口(WAP)

17. 推荐经销商接口(WAP)

18. 城市数据接口(WAP)

19. 贷款申请提交接口(WAP)

20. 我的订单接口(WAP)

21. 发送验证码申请接口(WAP)

22. 核对验证码接口(WAP)

23. 金融列表数据字典接口(WAP)

Attachments

Download in other formats: