pcauto_4.1.0/interface – iphone

Wiki

wiki:pcauto_4.1.0/interface

Context Navigation

Version 15 (modified by leijingtang, 12 years ago) (diff)
--

Table of Contents

1.基本约定

1.当接口处理正常时，HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。

2.当接口处理异常时，HTTP STATUS CODE 返回给500，并且给出具体的错误信息。
    {
	"uri" : "/intf/albums-by-type.jsp",
	"error-desc":"Need you follow uid.",
        "user-notice":"给用户的提示放在这里"
    }

    
3.接口默认的字符编码是UTF-8，接口需要实现对req_enc和resp_enc参数的支持。在JSP的最顶部，实现类似下面的代码：
注意：需要用getQueryString()，不能用getParameter()
String queryString = request.getQueryString();
String reqEnc = getQueryValue(queryString,"req_enc=");
if(reqEnc!=null){
    request.setCharacterEncoding(reqEnc);
}
String respEnc = getQueryValue(queryString,"resp_enc=");
if(respEnc!=null){
    //out.println(respEnc);
    response.setCharacterEncoding(respEnc);
}
String getQueryValue(String queryString,String key){
    if(queryString==null || queryString.length()==0)return null;
    int reqIdx = queryString.indexOf(key);//req_enc=utf-8&resp_enc=gbk
    if(reqIdx!=-1){
        reqIdx = reqIdx+key.length();
        int endIdx = reqIdx;
        for (; 
        endIdx < queryString.length() && queryString.charAt(endIdx)!='&'; 
        endIdx++) {
        }
        if(endIdx>reqIdx){
            return queryString.substring(reqIdx,endIdx);
        }
    }
    return null;
}

4.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。

5.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号。

6.需要登录的接口，cache-control=600 ；分开优先级低和主动请求两种，前者用cacheFirst，后者用noCache

2.接口列表

2.1 车系相关文章列表

    url:
        http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/3524?pageNo=1&pageSize=20
        http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/3524?pageNo=1&pageSize=20
        http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/3524?pageNo=1&pageSize=20
        http://mrobot.pcauto.com.cn/v3/price/getArticlePriceListBySerialId/3524?pageNo=1&pageSize=20&areaId=1
    作用:获取某个车系下的文章列表，在原来的基础上添加顶踩数
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

[
        {
            "channel":"汽车报价",
            "commentNum":"0",
            "id":"3590182",
            "image":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1210/01/c0/14229062_14229062_1349107127921_500.jpg",
            "pubDate":"2013-12-16 00:15:39",
            "title":"奥迪A4L广州优惠4万元 让利幅度已收紧",
            "ups":123,
            "downs":123
        }
]

2.2 伪造顶踩数

http://mrobot.pcauto.com.cn/v2/cms/channels/1?pageNo=1&pageSize=20&serialIds=2143,3404&v=4.0.0
http://mrobot.pcauto.com.cn/v2/cms/channels/55555?pageNo=1&pageSize=20&areaId=1&v=4.0.0
http://mrobot.pcauto.com.cn/v2/cms/channels/2?pageNo=1&pageSize=20&v=4.0.0
http://mrobot.pcauto.com.cn/v2/cms/serialMixedData/2143?pageNo=1&pro=%E5%B9%BF%E4%B8%9C%E7%9C%81&city=%E5%B9%BF%E5%B7%9E%E5%B8%82&v=4.0.0
http://mrobot.pcauto.com.cn/v3/bbs/hot?pageNo=1&pageSize=20
http://mrobot.pcauto.com.cn/v3/bbs/newForums/17369?pageNo=1&pageSize=19&orderby=postat
http://mrobot.pcauto.com.cn/v3/price/getNewsListBySerialId/3524?pageNo=1&pageSize=20
http://mrobot.pcauto.com.cn/v3/price/getProfileListBySerialId/3524?pageNo=1&pageSize=20
http://mrobot.pcauto.com.cn/v3/price/getGuideListBySerialId/3524?pageNo=1&pageSize=20
http://mrobot.pcauto.com.cn/v3/price/getArticlePriceListBySerialId/3524?pageNo=1&pageSize=20&areaId=1

对以上接口的顶踩数分别乘以50

2.3 推荐图集

    url:todo
    作用:滚动到图集最后一张图后显示推荐图集
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

[
{
"id":123,  // 图集id
"image":"http://111111",  // 图集封面图，尺寸待定
}
]

2.4 左侧栏菜单

    url:todo
    作用:获取左侧栏菜单，在原来的基础上添加广告数据；如果是广告数据则添加对应的计数字段，否则不变。
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

[
  {
  "id":1,
  "img":"http://www1.pcauto.com.cn/mobile/ceshi/home.png",
  "title":"首页",
  "view":"information-home/",
  "url":"",
  "vc-uri":"",
  "cc-uri":"",
  "vc3d-uri":"",
  "cc3d-uri":""
  }
]

2.5 推荐订阅

    url:todo
    作用:获取推荐订阅，在原来的基础上添加广告数据；如果是广告数据则添加对应的计数字段，否则不变。
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

{
    "manufacturers":[
        {
            "id":3895,
            "name":"途观",
            "vc-uri":"",
            "cc-uri":"",
            "vc3d-uri":"",
            "cc3d-uri":""
        }
    ]
}

2.6 热门车系

    url:todo
    作用:获取热门车系，在原来的基础上添加广告数据；如果是广告数据则添加对应的计数字段，否则不变。
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

{
    "manufacturers":[
        {
            "id":3895,
            "name":"途观",
            "priceRange":"18.98~31.58万",
            "kind":"中型SUV",
            "photo":"http://img0.pcauto.com.cn/pcauto/1311/25/3461900_tuguan.jpg",
            "vc-uri":"",
            "cc-uri":"",
            "vc3d-uri":"",
            "cc3d-uri":""
        }
    ]
}

2.7 默认订阅车系

    url:todo
    作用:获取默认订阅车系，在原来的基础上添加广告数据；如果是广告数据则添加对应的计数字段，否则不变。
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

{
    "serialList":[
        {
            "serialId": 3404,
            "serialName": "福克斯",
            "price": "9.98-16.99万",
            "image":"http://img.pconline.com.cn/images/upload/upc/tx/auto5/1307/24/c16/23702964_1374654889218_270x202.jpg"
            "vc-uri":"",
            "cc-uri":"",
            "vc3d-uri":"",
            "cc3d-uri":""
        }
    ]
}

2.8 新增广告

    url:http://mrobot.pcauto.com.cn/v3/ad
    作用:获取广告，在原来的基础上添加以下广告
    使用范围:汽车网app

    HTTP请求方式：get                         
    是否需要登录：否                          
    请求参数：none
    设计稿：
    返回参数：

置顶帖子：
“auto.khd.zx.zdtz"

{
     “rule”:{
          “age”:123,
          ”interval”:123,
          ”delay”:2
     },
     “ad”:{
          “title”:”这是论坛置顶帖”,
          “img”:”http://xxxxxx”,
          “ups”:123,
          “downs”:123,
          “commentCount”:123,
          “to-uri”:””,
          “vc-uri”:””,
          “cc-uri”,
          “vc3d-uri”,
          “cc3d-uri"
     }
}

搜车关键字：
“auto.khd.zx.scgjz"
{
     “ad”:{
          “title”:”这是关键字”,
          “vc-uri”:””,
          “cc-uri”:””,
          “vc3d-uri”:””,
          “cc3d-uri”:""
     }
}

车型页中栏：
“auto.khd.zx.cxyzl"
{
    "rule":{
        "delay":1,
        "interval":10,
        "age":10
    },
    "ad":{
        "img":"http://219.136.245.79/demo/ad/banner.png",
        "to-uri":"http://flv.pcvideo.com.cn/pconline/videocenter/interior/2013/01/30/A31EB18313043006.mp4",
        "vc-uri":"http://127.0.0.1:8080/click.jsp?type=vc",
        "cc-uri":"http://127.0.0.1:8080/click.jsp?type=cc",
        "vc3d-uri":"http://192.168.20.6?a=3d",
        "cc3d-uri":"http://192.168.20.68?a=3d"
    }
} 

推荐图集：
“auto.khd.zx.tjtj"
{
    "ad":{
        "img":"http://219.136.245.79/demo/ad/banner.png",
        "to-uri":"http://flv.pcvideo.com.cn/pconline/videocenter/interior/2013/01/30/A31EB18313043006.mp4",
        "vc-uri":"http://127.0.0.1:8080/click.jsp?type=vc",
        "cc-uri":"http://127.0.0.1:8080/click.jsp?type=cc",
        "vc3d-uri":"http://192.168.20.6?a=3d",
        "cc3d-uri":"http://192.168.20.68?a=3d"
    }
} 





启动图动画
“auto.khd.zx.qdtdh" 
{
    "rule":{
        "delay":1,
        "interval":10,
        "age":10
    },
    "ad":{
        "img":"http://219.136.245.79/demo/ad/banner.png",
        "to-uri":"http://flv.pcvideo.com.cn/pconline/videocenter/interior/2013/01/30/A31EB18313043006.mp4",
        "vc-uri":"http://127.0.0.1:8080/click.jsp?type=vc",
        "cc-uri":"http://127.0.0.1:8080/click.jsp?type=cc",
        "vc3d-uri":"http://192.168.20.6?a=3d",
        "cc3d-uri":"http://192.168.20.68?a=3d"
    }
}

 
个人中心运营位
“auto.khd.zx.grzxyyw"
{
    "ad":{
        "title”:”这是个人中心运营位",
        "to-uri":"x",
        "vc-uri":"x",
        "cc-uri":"x",
        "vc3d-uri":"x",
        "cc3d-uri":"x"
    }
} 



评论上方运营位
“auto.khd.zx.plsfyyw"
{
    "ad":{
        "title”:”这是评论上方运营位",
        "to-uri":"x",
        "vc-uri":"x",
        "cc-uri":"x",
        "vc3d-uri":"x",
        "cc3d-uri":"x"
    }
}

3.开发时间、负责人、进度和实现方式

批次	页面	涉及MROBOT接口	是否需要 HTML切图	需配合的接口负责人及进度	接口开发预计时间	接口进度（百分比）	接口实际完成时间	实现方式
第一批	首页	2.1 车系相关文章列表	-	-	-		-
第一批	首页	2.3 推荐图集	-	-	-		-
第一批	首页	2.2 伪造顶踩数	-	-	-		-
第二批	首页	2.4 左侧栏菜单	-	-	-		-
第二批	首页	2.8 新增广告	-	-	-		-
第二批	首页	2.5 推荐订阅	-	-	-		-
第二批	首页	2.6 热门车系	-	-	-		-
第二批	首页	2.7 默认订阅车系	-	-	-		-

Download in other formats:

Plain Text