wiki:pcauto_BuyAuto_1.3.0

Version 29 (modified by wuxiaoling, 11 years ago) (diff)

--

Table of Contents

  1. 1.基本约定
  2. 接口列表
  3. 1.历史记录
  4. 2.车系列表
  5. 3.发起投票
  6. 4.投票列表
  7. 5.更新投票状态
  8. 6.图片终端页
  9. 7.投票详情

1.基本约定

接口通用参数
req_enc=utf-8(必须放url后面)
resp_enc=utf-8(必须放url后面)
common_session_id=xxxx(以cookies中的优先)

接口URL: 接口URL
必填参数：参数名=xxx(多种情况用括号解析)
非必填参数：参数名=xxx(多种情况用括号解析)
说明文档参数：添加某特定参数可以直接看接口文档
是否需要登录：是,否
返回格式：json,ssi,xml
缓存方式：接口缓存（接口中返回的响应头里面的 Cache-Control），对象缓存（）
缓存时间：缓存时间
返回结果：结果可能情况


代理环境说明：
192.168.10.198 端口为 1080 连的是v80的测试环境（192.168.74.80）
192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）

接口列表

1.历史记录

(mrobot开发已完成，请连开发机进行测试)

 http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/listMinModelPrice.xsp?modelIds=33313,33314,33315&areaId=1

后端接口

 http://price.pcauto.com.cn:8001/interface/iphone/atom/dealer/list_min_model_price_json.jsp?vs=1.3&rId=1&mIds=33313,33314,33315 本地最底价  http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?vs=1.3&mIds=33313,33314,33315 官方价

说明

areaId不传的情况下默认为1

提交方式

GET

参数

参数名 参数含义 类型 默认值 是否必须
modelIds车型String 无是
areaId地区Idint1是

返回 

 {
    "models": [
        {
            "mId": 33314,
            "minPrice": 28.3,
            "markDown": 4.99
        },
        {
            "mId": 33315,
            "minPrice": 31.32,
            "markDown": 5.96
        },
        {
            "mId": 33313,
            "minPrice": 26.59,
            "markDown": 4.69
        }
    ],
    "code": 1
}

2.车系列表

(mrobot开发已完成，请连开发机进行测试)

 http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/getSerialListByBrandId.xsp?brandId=1&type=1

后端接口

 http://price.pcauto.com.cn/interface/iphone/serialGroup_list_v2.jsp?vs=1.3&bid=1&type=1 车系列表数据
 http://price.pcauto.com.cn/interface/iphone/atom/price/hot_model_list_json.jsp?vs=1.3&brandId=1 本地热门车型最低价

说明

本地热门车型最低价新加的接口

提交方式

GET

参数

参数名 参数含义 类型 默认值 是否必须
brandId品牌int 1是
typeId类型Idint1是

返回 

  {
   "manufacturers":[{
        "brandName": "奥迪",
        "name": "测试的",
        "brandIntroduction": "http://baike.pcauto.com.cn/204.html",
        "serials": []
    },
    {
        "brandName": "奥迪",
        "name": "一汽奥迪",
        "brandIntroduction": "http://baike.pcauto.com.cn/204.html",
        "serials": [
            {
                "id": 3524,
                "name": "奥迪A4L",
                "kind": "中型车",
                "priceRange": "27.28~57.81 万",
                "isNew": 0,
                "sellStatus": 3,
                "carVersion": 1,
                "carField": 4,
                "photo": "http://img.pconline.com.cn/images/upload/upc/tx/auto5/1408/11/c1/37285606_37285606_1407725980801_180x135.jpg",
                "count": 43
            } .....
   ],
   "models":[ {
        "mId": 30822,
        "serialGroupId": 5
    },
   {
        "mId": 26741,
        "serialGroupId": 6
    }.....
    ]
   }

3.发起投票

(mrobot开发已完成，请连开发机进行测试)

 http://mrobot.pcauto.com.cn/buy/price/vote/initiateVote

说明

发起投票接口

提交方式

POST

参数

参数名 参数含义 类型 默认值 是否必须
param投票json数据json 无是

请求参数格式 

  {
    “deviceId”: ”设备唯一标识”,
    “text”: ”帮我选车吧”,
    “validTime”: 3,
    “cars”: [
        {
            “serialId”: 4313,
            “areaId”: 12,
            “name”: ”奥迪A4L”,
            “image”: ”图片url”,
            “price”: ”￥27~30万”
        },
        {
            “serialId”: 4313,
            “areaId”: 12,
            “name”: ”奥迪A4L”,
            “image”: ”图片url”,
            “price”: ”￥27~30万”
        }
    ]
}

字段说明

参数名 参数含义
deviceId设备唯一标识
text投票文案
validTime有效时间，单位(天)，一周7天，一个月30天
cars车系列表，json数组
serialId车系id
areaId投票发起人所在区域id
name车系名称
image车系图片的url
price车系价格

返回值 返回结果： 

{
“code”:200,
“msg”:”投票成功”
}

返回码 200- 投票成功
405- 需要使用POST请求
400- 请求参数有误
500 - 系统错误

4.投票列表

(mrobot开发已完成，请连开发机进行测试)

 http://mrobot.pcauto.com.cn/buy/price/vote/getVotes?deviceId={deviceId}
样例： http://mrobot.pcauto.com.cn/buy/price/vote/getVotes?deviceId=4e668331ec9d3275a7da459f6748a76d

说明

查询投票列表接口

提交方式

GET

参数

参数名 参数含义 类型 默认值 是否必须
deviceId设备唯一标识int 无是

返回结果格式 

  {
    "votes": [
        {
            "cars": [
                {
                    "areaId": 12,
                    "image": "url",
                    "name": "奥迪 A4L",
                    "price": "￥27~30万",
                    "serialId": 4313
                }
            ],
            "status": 0,
            "validTime": {
                “start”: ”2015-05-30”,
                “end”: ”2015-06-30”
            },
            "voterCount": 8,
            “id”: 3241
        }
    ],
    “code”: 200,
    “msg”: ”成功”
}

字段说明

参数名 参数含义
votes投票列表，json对象
cars车系列表，json对象
serialId车系id
areaId投票发起人所在区域id
name车系名称
image车系图片的url
price车系价格
status投票状态，0：进行中，1：关闭，2：结束
validTime有效时间，json对象
start开始时间，字符串
end结束时间，字符串
id投票唯一标识
code响应码
msg响应信息

返回码 405- 需要使用GET请求
400- 请求参数有误
500 - 系统错误

5.更新投票状态

(mrobot开发已完成，请连开发机进行测试)

 http://mrobot.pcauto.com.cn/buy/price/vote/operateVote/{voteId}?opId={opId}
样例： http://mrobot.pcauto.com.cn/buy/price/vote/operateVote/2141?opId=1

说明

关闭，删除投票接口

提交方式

GET

参数

参数名 参数含义 类型 默认值 是否必须
voteId投票唯一标识int 无是
opId操作标识，1：关闭，3：删除int 无是

返回结果格式 

  {
“code”:200,
“msg”:”成功”
}

返回码
200- 成功
405- 需要使用GET请求
400- 请求参数有误
500 - 系统错误

6.图片终端页

 http://mrobot.pcauto.com.cn/xsp/s/auto/buy/v1.3/pictures.xsp?serialGroupId=4457&pageSize=60&pageNo=1&typeId=1&modelId=36339&colorId=0
后端接口

 http://price.pcauto.com.cn/interface/iphone/photo_page_list.jsp?vs=1.3&typeId=1&pageNo=1&pageSize=20&modelId=36339&serialGroupId=4457&cateId=1&colorId=0基础数据  http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?vs=1.3&mIds=36339 官方价

说明

无

提交方式

GET

参数

参数名 参数含义 类型 默认值 是否必须
typeId类型Idint1是
pageNo第几页int1否
pageSize分页个数int6否
serialGroupId车系Idint0否
modelId车型Idint0否
cateId种类Idint0是
colorId颜色Idint0是

返回 

 {
    "total": 37,
    "pageNo": 1,
    "pageSize": 2,
    "pageCount": 19,
    "title": "外观",
    "data": [
        {
            "modelId": "36339",
            "modelName": "奥迪Q5 2015款 40 TFSI 技术型 ",
            "bigPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_400x300.jpg",
            "smallPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487751874_120x90.jpg",
            "gfPrice": "43.16"
        },
        {
            "modelId": "36339",
            "modelName": "奥迪Q5 2015款 40 TFSI 技术型 ",
            "bigPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487754873_400x300.jpg",
            "smallPath": "http://img.pcauto.com.cn/images/upload/upc/tx/auto5/1412/25/c1/1097875_1097875_1419487754873_120x90.jpg",
            "gfPrice": "43.16"
        }
    ]
}

7.投票详情

(mrobot开发已完成，请连开发机进行测试)

 http://mrobot.pcauto.com.cn/buy/price/vote/detailVote/{voteId}
样例： http://mrobot.pcauto.com.cn/buy/price/vote/detailVote/1232[[BR]]

说明

查询投票详细信息接口

提交方式

GET

参数

参数名 参数含义 类型 默认值 是否必须
voteId投票idint 无是

返回结果格式 

  {
    "code": 200,
    "msg": "成功",
    "vote": {
        "cars": [
            {
                "areaId": 12,
                "image": "url",
                "name": "奥迪 A4L",
                "price": "￥27~30万",
                "serialId": 4313,
                "ticketCount": 1,
                "percent": 100
            }
        ],
        "id": 1,
        "status": 0,
        "tickets": [
            {
                "name": "name",
                "reason": "reason",
                "time": "2015-06-02",
                "voter": "voter"
            }
        ],
        "validTime": {
            "end": "2015-06-05",
            "start": "2015-06-02"
        },
        "voteCount": 1
    }
}

字段说明

参数名 参数含义
votes投票列表，json对象
cars车系列表，json对象
serialId车系id
areaId投票发起人所在区域id
name车系名称
image车系图片的url
price车系价格
ticketCount车系得票数
percent车系得票百分数，整数
tickets选票信息，json对象
voter投票人名称
time投票日期
name车系名
reason投票原因
status投票状态，0：进行中，1：关闭，2：结束
voteCount总投票次数
validTime有效时间，json对象
start开始时间，字符串
end结束时间，字符串
id投票唯一标识
code响应码
msg响应信息

返回码 405- 需要使用GET请求
400- 请求参数有误
500 - 系统错误

Attachments