Changes between Version 10 and Version 11 of baby3_developers/interface

Timestamp:

12/24/2014 02:48:34 PM (11 years ago)

Author:

lianchijin

Comment:

--

baby3_developers/interface

@@ -37 +37 @@
 === 1.0首页 ===
 {{{
-  备注：首页接口，在V2.0接口的基础上更改，根据参数 v >=2.1.0，则焦点图增加视频类文章页、问答专栏详情的推广，热门栏目增加崔玉涛专栏
+  备注：首页接口
+  接口说明：参照亲子V2.0接口--1.0首页（http://trac.pc.com.cn/iphone/wiki/baby/interface#a1.0首页），添加参数v＝2.1.0，根据参数 v >=2.1.0，则焦点图增加视频类文章页、问答专栏详情的推广，热门栏目增加崔玉涛专栏
   接口开发：庄焕斌
   原始URL：
@@ -56 +57 @@
    focus:[  //焦点图数据（增加视频类文章页、问答专栏详情的推广）
      {
-       id:
+       id:  // 推“专栏详情”的推广时id为专栏期数的id
        image:
        title:
@@ -118 +119 @@
        [
              {
-                "videoID": //  视频id
+                "videoId": //  视频id
                 "title": //  视频标题
                 "time":  //  视频时间
@@ -153 +154 @@
  _HTML_META_END_@*/
  }}}
+
+=== 5.0问答专栏 ===
+{{{
+  备注：问答专栏
+  接口开发：
+  原始URL：
+  请求URL：
+  HTTP请求方式：get
+  是否需要登录：否
+  返回格式：JSON
+  缓存方式：无
+  缓存时间：无
+  请求参数：
+  无
+  返回参数:
+{
+    status: 0, //状态码  0正常返回   非0请求错误
+    desc: "",  //提示信息    status＝0提示信息为空；status非0，给出对应的出错提示信息
+   "total": 20,  //列表总数
+   "pageNo": 1, //当前页码
+   "pageSize": 20, //每页条数
+   "datas": //返回数据
+       [
+             {
+                "id": //  专栏期数id
+                "title": //  专栏标题
+                "time":  //  时间
+                "image": //  专栏图片
+             }
+             ...
+      ]
+}
+}}}
+
+==== 5.1专栏详情 ====
+{{{
+  备注：专栏详情
+  接口开发：
+  原始URL：
+  请求URL：
+  HTTP请求方式：get
+  是否需要登录：否
+  返回格式：JSON
+  缓存方式：无
+  缓存时间：无
+  请求参数：
+  id  //专栏期数id
+  返回参数:
+{
+   "status":   //状态码  0正常返回   非0请求错误
+   "desc": ""  //提示信息    status＝0提示信息为空；status非0，给出对应的出错提示信息
+   "id":  //  专栏期数id
+   "title":   //  专栏标题
+   "expertFace": //专家头像
+   "authorName":  //专家名
+   "department"://专家所在部门
+   "hospital":    //专家所在医院名称
+   "typeId":  //专家所在领域id
+   "detail":   //专栏详情介绍
+   "questionDatas": //问答数据
+       [
+          {
+            "questionId":  // 问题id
+            "authorFace":  // 用户头像
+            "authorName":  // 用户名称
+            "question":   // 问题描述
+            "answer":  // 回答内容
+            "authorId":  //用户id
+          },
+             ...
+      ]
+  "total": 20,  //问答总数
+  "pageNo": 1, //当前页码
+  "pageSize": 20, //每页条数
+
+}
+}}}
+
+===== 5.1.2提问 =====
+{{{
+  备注:提问，默认为崔玉涛专栏的提问
+  接口开发：
+  请求URL：http://
+  接口说明：
+  HTTP请求方式：post
+  是否需要登录：是
+  返回格式：JSON
+  缓存方式：无
+  缓存时间：无
+  请求参数：
+   title：问题标题
+   des = 问题描述;
+   typeId = 问题分类id
+   specialistId:专家id,
+   设置header  Cookie = "common_session_id=xxxx";
+  返回参数
+  {
+   msg:
+   result: //结果状态码   0提问成功  非0返回对应的出错信息 
+  }
+}}}
+
+==== 5.2 问答终端 ====
+{{{
+  备注:问答终端  
+  接口说明：参照亲子V2.0接口--5.2问答详情（http://trac.pc.com.cn/iphone/wiki/baby/interface#a5.2问答详情），增加参数type=1（表示崔玉涛栏目下的问题），则终端页添加浮层广告
+  接口开发：
+  原始URL：
+  请求URL：
+  
+  HTTP请求方式：get
+  是否需要登录：否
+  返回格式：HTML页面
+  缓存方式：无
+  缓存时间：无
+  请求参数：
+  id:  // 问题id
+  type ＝ 1 // 表示崔玉涛栏目下的问题
+  返回参数:
+
+  点击协议:
+  pcaction://adopt-answer/id
+  pcbabybrowser://PCBabyFullWebView/?url=http://xxxx（广告url）
+}}}