Changes between Version 1 and Version 2 of pchouse_magazine_interface_3.4.0


Ignore:
Timestamp:
05/18/2016 04:47:39 PM (10 years ago)
Author:
hezhenwei1
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • pchouse_magazine_interface_3.4.0

    v1 v2  
    11[[TOC]] 
    2  
    3 = Choice(悦选)2.0.0接口文档 = 
    4 >mrobot代理环境说明:  
    5      192.168.10.198:1080(192.168.74.80)[[BR]]  
    6      192.168.10.199 端口为 1080 连的是dev40的开发环境(192.168.75.40)[[BR]]  
    7      ps1:未到qa阶段,连开发环境调试(若仅做代理,mrobot不存在真正的处理文件,只作转发的功能) [[BR]]  
    8      ps2:common_session_id都是在cookies中添加此参数 [[BR]] 
    9  
    10      [http://rdtrac.pc.com.cn/mobile/pototype/pclady/Choice2.0.0 "框架"][[BR]] 
    11      [http://192.168.50.171/2015/2015-12-02/index.html "设计稿地址"][[BR]] 
    12      [http://rdtrac.pc.com.cn/iphone/wiki/pclady_news2.0.0终端协议 "终端协议"][[BR]] 
    13      [http://rdtrac.pc.com.cn/cmt/wiki/intf "评论系统接口"][[BR]] 
     2= 家居杂志iPhone3.4.0接口文档 = 
     3>环境说明: 
     4      
     5     [http://trac.pc.com.cn/mobile/pototype/pchouse-mag/3.4.0/v4/ "产品文档"][[BR]] 
     6     [ "设计稿地址"][[BR]] 
     7     [http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.4.0-protocol "终端页协议"][[BR]] 
    148 
    159 
    16 >评论用到的URL: 
    17 文章              http://choice.pclady.com.cn/pcladynews/article/id.html [[BR]] 
    18 投票/活动           http://choice.pclady.com.cn/pcladynews/activity/id.html [[BR]] 
    19 == 1.首页 == 
     10 
     11== 1.圈子 == 
    2012---------- 
    21  
    22 === 1.1资讯首页 === 
    23 开发环境:http://dev15.pclady.com.cn:8004/app/dailyArticles.jsp [[BR]] 
    24 线上环境:http://choice.pclady.com.cn/app/dailyArticles.jsp [[BR]] 
    25 mrobot地址:http://mrobot.pclady.com.cn/x-300/choice-choice/app/dailyArticles.jsp?date=2016-01-19 
     13=== 1.1精选帖子列表 === 
     14robot:/selectedTopic.xsp [[BR]] 
     15虚拟币系统:/selectedTopicIds.jsp[[BR]] 
     16论坛系统:[http://trac.pc.com.cn/iphone/wiki/pchouse_magazine_interface_3.3.0#a3.2根据帖子id批量获取帖子详情 "根据帖子id批量获取帖子详情"][[BR]] 
    2617 
    2718**说明** 
    28  
    29 > 获取资讯栏目的首页精选数据。[[BR]] 
    30 > 列表中的文章数据按天(服务器时间)进行分页,每次返回的数据为某一天的文章数据,参数中用date来标识,如果date为空表示加载当天数据,随后后端返回数据时需要一同返回这些数据是属于哪天的,以及有数据的下一天的日期nextDate。[[BR]] 
    31 > 数据异常机制:当天必须要有焦点文章,如果没有焦点文章,即使有文章数据也跳过该天,随后返回最近有焦点文章那天的文章列表。假如已经到了最后一天,nextDate返回为空。 
     19> 获取精选帖子列表数据,最多30条精选帖子,每页10条,最多3页。 
     20> 帖子数据保存在论坛系统,但精选帖子的id保存在虚拟币系统,所以需要mrobot端先从虚拟币系统获取所有精选帖子的id,再根据分页页数带上对应的帖子id到论坛系统查询帖子数据。 
    3221 
    3322**缓存时间** 
    34  
    35 >mrobot与后台都为5分钟 
     23>无缓存 
    3624 
    3725**提交方式** 
    38  
    3926> GET 
    4027 
    4128**是否登录** 
    42  
    4329> 否 
    4430 
    4531**数据来源** 
    46  
    47 >编辑后台 
     32>虚拟币系统 
     33>论坛系统 
    4834 
    4935**参数** 
    50  
    5136||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| 
    5237||date||指定日期||string||""||否||= 为空时返回服务器当天数据,随后使用后端返回的nextDate来请求,格式YYYY-MM-DD =|| 
    5338 
    5439**返回** 
    55  
     40mrobot: 
    5641{{{#!java 
    5742{ 
     
    7055      "desc":"文章正文前80字", 
    7156      "focusImageUrl":"焦点文章图片"  //为文章配置的焦点图 
    72     }, 
    73     "articleList":[ 
    74       {  
    75         "specialID":"所属一级专题ID", 
    76         "specialName":"所属一级专题名称", 
    77         "authorID":"作者ID", 
    78         "authorName":"作者昵称", 
    79         "authorUrl":"作者头像", 
    80         "articleID":"文章id", 
    81         "imageUrl":"文章图片", 
    82         "title":"文章标题", 
    83         "desc":"文章正文前80字" 
    84       } 
    85     ], 
    86     "focusImage":{  //焦点图 
    87       "focusID":"焦点图ID", 
    88       "imageUrl":"焦点图片", 
    89       "desc":"焦点图简介" 
    9057    } 
    9158  } 
    9259} 
     60}}} 
    9361 
     62虚拟币系统: 
     63{{{#!java 
     64{ 
     65  "status":0, 
     66  "msg":"请求成功", 
     67  "data":{ 
     68    "date":"数据所属日期",//YYYY-MM-DD 
     69    "nextDate":"下次请求的日期",//YYYY-MM-DD 
     70    "focusArticle":{  //焦点文章 
     71      "authorID":"作者ID", 
     72      "authorName":"作者昵称", 
     73      "authorUrl":"作者头像", 
     74      "articleID":"文章id", 
     75      "imageUrl":"文章图片", 
     76      "title":"文章标题", 
     77      "desc":"文章正文前80字", 
     78      "focusImageUrl":"焦点文章图片"  //为文章配置的焦点图 
     79    } 
     80  } 
     81} 
    9482}}} 
     83 
    9584**返回参数说明** 
     85mrobot: 
    9686||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
    9787||= authorName =||= 作者昵称 =||= authorID =||= 作者ID =|| 
    9888||= focusDate =||= 焦点图上显示的时间 =||= =||=  =|| 
    9989 
     90虚拟币系统: 
     91||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| 
     92||= authorName =||= 作者昵称 =||= authorID =||= 作者ID =|| 
     93||= focusDate =||= 焦点图上显示的时间 =||= =||=  =|| 
    10094[[BR]]