wiki:pcauto_BuyAuto_1.3.0

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

--

Table of Contents

  1. 1.基本约定
  2. 接口列表
  3. 1.历史记录
  4. 2.车系列表
  5. 3.发起投票
  6. 4.投票列表
  7. 4.更新投票状态

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 连的是v36的测试环境（192.168.74.36）
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?rId=1&mIds=33313,33314,33315 本地最底价  http://price.pcauto.com.cn/interface/iphone/atom/price/model_basic_json.jsp?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?bid=1&type=1 车系列表数据  http://price.pcauto.com.cn/interface/iphone/atom/price/hot_model_list_json.jsp?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.发起投票

 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.投票列表

 http://mrobot.pcauto.com.cn/buy/price/vote/getVotes/{deviceId}
样例： http://mrobot.pcauto.com.cn/buy/price/vote/getVotes/123512314123

说明

查询投票列表接口

提交方式

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响应信息

返回值 返回结果： 

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

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

4.更新投票状态

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

说明

关闭，删除投票接口

提交方式

GET

参数

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

返回结果格式 

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

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

Attachments