wiki:pcauto_BuyAuto_1.3.0

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

--

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万”
        }
    ]
}

返回值 返回结果:

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

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

Attachments