Changes between Initial Version and Version 1 of pconline_3.9.0/interface

Timestamp:

07/18/2014 03:19:43 PM (12 years ago)

Author:

tianjie

Comment:

--

pconline_3.9.0/interface

@@ +1 @@
+== 1.基本约定 ==
+{{{
+接口通用参数
+req_enc=utf-8(必须放url后面)
+resp_enc=utf-8(必须放url后面)
+common_session_id=xxxx(以cookies中的优先)
+
+接口URL: 接口URL
+必填参数：参数名=xxx(多种情况用括号解析)
+非必填参数：参数名=xxx(多种情况用括号解析)
+说明文档参数：添加某特定参数可以直接看接口文档
+是否需要登录：是,否
+返回格式：json,ssi,xml
+缓存方式：接口缓存，对象缓存
+缓存时间：缓存时间
+返回结果：结果可能情况
+}}}
+
+== 2.接口列表 ==
+=== 2.1 [=#point201 添加文章收藏] ===
+{{{
+备注：此接口添加文章收藏到已登录用户中；直播文章无收藏功能
+mrobot url：暂无
+Web端 url：http://bip.pconline.com.cn/intf/article.jsp?act=addArtCollect&siteId=1&articleId=5105797&callback=（Web端收藏文章）
+HTTP请求方式：get
+是否需要登录：是
+返回格式：json
+缓存方式：无
+缓存时间：无
+请求参数：
+    act：请求动作，addArtCollect为添加收藏
+    siteId:主网站id，电脑网为1
+    articleId：文章id
+    callback：回调方法，Web端通过jsonp方式传递回调方法，客户端不使用该参数
+1、正常返回
+{
+    "code":0,
+    "message":"31356890用户收藏文章成功！"
+}
+2、异常返回
+{
+    "code":1,
+    "message":"该文章已被该用户收藏"
+}
+}}}
+
+=== 2.2 [=#point202 取消文章收藏] ===
+{{{
+备注：此接口取消已登录用户的文章收藏；直播文章无收藏功能
+mrobot url：暂无
+Web端 url：http://my.pconline.com.cn/bip/intf/article.jsp?act=delMyCollection&siteId=1&articleId=5105797（Web端取消收藏文章）
+HTTP请求方式：get
+是否需要登录：是
+返回格式：json
+缓存方式：无
+缓存时间：无
+请求参数：
+    act：请求动作，delMyCollection为取消收藏
+    siteId:主网站id，电脑网为1
+    articleId：文章id
+1、正常返回
+{
+    "code":0,
+    "message":"删除收藏文章成功！"
+}
+}}}
+
+=== 2.3 [=#point203 已收藏文章列表] ===
+{{{
+备注：此接口返回已登录用户已收藏的文章列表
+mrobot url：http://mrobot.pconline.com.cn/v3/itbbs/collectionDownload/31356890?pageSize=20&pageNo=1
+Web端 url：http://my.pconline.com.cn/collection/myArticle.jsp（Web端个人中心获取已收藏文章列表）
+HTTP请求方式：get
+是否需要登录：是
+返回格式：json
+缓存方式：无
+缓存时间：无
+请求参数：
+    pageNo：当前请求页码
+    pageSize：每页返回条数
+返回参数说明：
+原接口数据保持不变，增加已收藏文章的返回信息
+    articleCount：已收藏文章数量
+    articlePageCount：已收藏文章的页数，根据articleCount和pageSize计算得到
+    articleList：根据pageNo和pageSize返回的已收藏文章列表
+文章列表字段：
+    id：收藏id
+    name：文章标题
+    articleId：文章id
+    imageUrl：文章的配图，若该文章没有图片，则为空
+返回结果：
+{
+    "forumCount": 11,
+    "forumList": [{
+        "forumId": 668543,
+        "id": 2903021,
+        "name": "iPhone综合讨论区"
+    }, {
+        "forumId": 769246,
+        "id": 2891611,
+        "name": "我要踢爆"
+    }],
+    "forumPageCount": 1,
+    "pieForumCount": 2,
+    "pieForumList": [{
+        "forumId": 76,
+        "id": 15438,
+        "name": "最吹水肥皂区"
+    }, {
+        "forumId": 48,
+        "id": 14400,
+        "name": "最数码二手闲置交易"
+    }],
+    "pieForumPageCount": 1,
+    "pieTopicCount": 4,
+    "pieTopicList": [{
+        "id": 15663,
+        "name": "从机械胶卷到数码CMOS，十年单反路--最后还有重武器“出仓”",
+        "topicId": 76565
+    }, {
+        "id": 15662,
+        "name": "好屌的自行车",
+        "topicId": 102316
+    }],
+    "pieTopicPageCount": 1,
+    "topicCount": 33,
+    "topicList": [{
+        "id": 2904262,
+        "name": "那些年，80后一起用过的电脑",
+        "topicId": 51599565
+    }, {
+        "id": 2869645,
+        "name": "各位高手能帮我看看这是什么牌子的电源吗",
+        "topicId": 51445926
+    }],
+    "topicPageCount": 2,
+    "articleCount": 2,
+    "articleList": [{
+        "id": 2904262,
+        "name": "500万画点！西铁城推出超高分辨率EVF",
+        "articleId": 5045678,
+        "imageUrl": "http://img0.pconline.com.cn/pconline/1407/04/5045678_1_thumb.jpg"
+    }, {
+        "id": 2869645,
+        "name": "免费WIFI无限畅玩 荣耀6专属WLAN初体验",
+        "articleId": 5027277,
+        "imageUrl": "http://img0.pconline.com.cn/pconline/1407/01/5027277_100.jpg"
+    }],
+    "articlePageCount": 1,
+    "pageCount": 2,
+    "pageNo": 1,
+    "pageSize": 20,
+    "total": 52
+}
+}}}
+
+=== 2.4 [=#point204 文章顶、踩接口] ===
+{{{
+备注：此接口对该文章进行顶、踩操作；直播文章无顶踩功能
+mrobot url：暂无
+Web端 url：http://bip.pconline.com.cn/intf/article.jsp?act=addArtAgree&siteId=1&articleId=5105797&isAgree=1&callback=（Web端顶、踩文章）
+HTTP请求方式：get
+是否需要登录：否
+返回格式：json
+缓存方式：无
+缓存时间：无
+请求参数：
+    act：请求动作，addArtAgree为顶文章
+    siteId:主网站id，电脑网为1
+    articleId：文章id
+    isAgree：顶或踩：1表示顶；2表示踩
+    callback：回调方法，Web端通过jsonp方式传递回调方法，客户端不使用该参数
+1、顶、踩文章正常返回
+{
+    "code":0,
+    "message":"用户赞、踩文章成功"
+}
+2.1、已顶过的文章再进行顶踩操作返回
+{
+    "code":1,
+    "message":"该文章已被该用户赞过"
+}
+2.2、已踩过的文章再进行顶踩操作返回
+{
+    "code":2,
+    "message":"该文章已被该用户踩过"
+}
+}}}
+
+=== 2.5 [=#point205 获取文章顶踩数据接口] ===
+{{{
+备注：此接口获取文章顶踩数据；直播文章无改功能
+mrobot url：暂无
+Web端 url：http://bip.pconline.com.cn/intf/article.jsp?act=getArticleCount&siteId=1&articleId=5105797&additionalCollect=0&additionalAgree=0&additionalAgainst=0（Web端获取文章顶踩数据）
+HTTP请求方式：get
+是否需要登录：否
+返回格式：json
+缓存方式：无
+缓存时间：无
+请求参数：
+    act：请求动作，getArticleCount为获取文章顶踩数据
+    siteId:主网站id，电脑网为1
+    articleId：文章id
+    additionalCollect：请与Web接口同事沟通
+    additionalAgree：请与Web接口同事沟通
+    additionalAgainst：请与Web接口同事沟通
+1、正常返回
+{
+    "id":848544,
+    "createTime":1405479564000,
+    "siteId":1,
+    "articleId":5105797,
+    "collectCount":0,
+    "addCollect":0,
+    "agreeCount":6,
+    "addAgree":0,
+    "againstCount":0,
+    "addAgainst":0
+}
+}}}