wiki:pcautofinance1.0_developers/interfaces

Version 93 (modified by caozhaoyuan, 11 years ago) (diff)

--

汽车金融WAP1.0接口文档

项目说明:

项目域名(微信): http://mrobot.pcauto.com.cn
项目域名(wap): http://m.jr.pcauto.com.cn

mrobot代理环境说明:

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


WAP端接口

1. 二维码接口(微信)

(mrobot开发中)
mrobot接口: http://mrobot.pcauto.com.cn/xsp/s/finance/jrweixin/qrcode.xsp?phoneId=
后端接口(微信): 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订单idlong0

返回数据

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

返回参数说明

参数名 参数含义


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "tab": "小型车",
            "data": [
                {
                    "serialid": 4123,
                    "modelid": 58724,
                    "name": "卡罗拉",
                    "payment": 2415,
                    "cost": 7000
                }
            ]
        },
        {
            "tab": "紧凑型车",
            "data": [
                {
                    "serialid": 4123,
                    "modelid": 58724,
                    "name": "卡罗拉",
                    "payment": 2415,
                    "cost": 7000
                }
            ]
        }
    ]
}

返回参数说明

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


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "tab": "推荐金融",
            "orgs": [
                {
                    "orgId": 1001,
                    "orgName": "招商银行",
                    "icon": "http://logo.png",
                    "prodId": 2001,
                    "prodName": "车易购",
                    "models": [
                        {
                            "serialId": 5124,
                            "modelId": 63512,
                            "name": "福特福克斯三厢",
                            "payment": 2415,
                            "cost": 7000
                        }
                    ]
                }
            ]
        },
        {
            "tab": "超低利率",
            "data": [
                {}
            ]
        }
    ]
}

返回参数说明

参数名 参数含义
list数组,包含4个数据对象
tab标签名称
orgs标签下的金融机构数据数组
orgId机构id
orgName机构名称
icon机构图片url
prodId产品id
prodName产品名称
serialid车系id
modelid车型id
name车系名
payment月供
cost贷款成本


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "id": 1,
            "name": "奥迪",
            "icon": "http://logo.png",
            "letter": "A",
            "hasDisProd": "true"
        },
        {
            "id": 2,
            "name": "AC宝马",
            "icon": "http://logo.png",
            "letter": "A",
            "hasDisProd": "false"
        }
    ]
}

返回参数说明

参数名 参数含义
list品牌数组
id品牌id
name品牌名
icon品牌图片url
letter品牌归属字母
hasDisProd是否有贴息产品


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "id": 1,
            "name": "奥迪",
            "icon": "http://logo.png",
            "letter": "A"
        },
        {
            "id": 2,
            "name": "AC宝马",
            "icon": "http://logo.png",
            "letter": "A"
        }
    ]
}

返回参数说明

参数名 参数含义
list品牌数组
id品牌id
name品牌名
icon品牌图片url
letter品牌归属字母


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "id": 1,
            "name": "奥迪",
            "icon": "http://logo.png",
            "letter": "A"
        },
        {
            "id": 2,
            "name": "AC宝马",
            "icon": "http://logo.png",
            "letter": "A"
        }
    ]
}

返回参数说明

参数名 参数含义
list品牌数组
id品牌id
name品牌名
icon品牌图片url
letter品牌归属字母


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "manufacturer": "上海大众",
            "serials": [
                {
                    "id": 1421,
                    "name": "朗逸",
                    "hasDisProd": "yes"
                },
                {}
            ]
        },
        {
            "manufacturer": "一汽大众"
        }
    ]
}

返回参数说明

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


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "list": [
        {
            "manufacturer": "上海大众",
            "serials": [
                {
                    "id": 1421,
                    "name": "朗逸"
                },
                {}
            ]
        },
        {
            "manufacturer": "一汽大众"
        }
    ]
}

返回参数说明

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


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

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

原型

 点击前往

说明

查询金融产品列表数据

调用方式

get

请求参数

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

返回数据

{
    "serialId": 5124,
    "modelId": 63512,
    "name": "福特福克斯三厢",
    "payment": 2415,
    "cost": 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车型名
payment月供
cost贷款成本
price经销商平均报价
icon车型图片url
list金融机构数组
orgName机构名称
icon机构图标url
products机构下产品数组
id产品id
name产品名称
payment月供
cost贷款成本
total金融机构总数
pageNo当期页码
pageSize每页数量


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "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

请求参数

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

param

{
   待定
}

返回数据

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

返回参数说明

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


13. 车型列表接口(WAP)

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

原型

 点击前往

说明

查询车系下的车型数据

调用方式

get

请求参数

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

返回数据

{
    "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产品idint
rid城市idint
modelId车型idint

返回数据

{
    "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城市idint
level级别int级别参数待定
bid品牌idint默认为空
prePayRange首付范围string范围参数待定
paymentRange月供范围string范围参数待定
sort排序stringdefault默认(default)、月供(payment)
pageSize每页数量int6每页数量按需求
pageNo当前页码int1

返回数据

{
    "list": [
        {
            "serialId": 5124,
            "modelId": 63512,
            "name": "福特福克斯三厢",
            "payment": 2415,
            "cost": 0.7
        },
        {
            "serialId": 5124,
            "modelId": 63512,
            "name": "福特福克斯三厢",
            "payment": 2415,
            "cost": 0.7
        }
    ],
    "total": 12,
    "pageNo": 1,
    "pageSize": 6
}

返回参数说明

参数名 参数含义
serialid车系id
modelid车型id
name车系名
payment月供
cost贷款成本
total车型总数
pageNo当前页码
pageSize每页数量


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

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

原型

 点击前往

说明

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

调用方式

get

请求参数

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

返回数据

{
    "loan": "500000",
    "proportion": 30,
    "payment": 21.34,
    "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最低首付
model车型信息json
modelId车型id
name车系名
title车型名
product产品信息json
orgId机构id
icon机构图标
orgName机构名
productId产品id
productName产品名
payment月供
cost贷款成本
ratio首付比例,后台材料
above高于首付需要的材料
below低于首付需要的材料
name材料名称
icon材料图片url


Attachments