Changes between Version 135 and Version 136 of baby/interface

Timestamp:

02/10/2015 02:29:45 PM (11 years ago)

Author:

lianchijin

Comment:

--

baby/interface

@@ -205 +205 @@
 
 === 3.0每日知识 ===
-==== 3.0每日知识首页 ====
+==== 3.1每日知识首页 ====
 {{{
   备注：每日知识首页
@@ -246 +246 @@
                 "title": "银耳薏米汤" //食谱标题
            }, 
-          {
+           {
                 "des": "宫寒会",
                 "id": 24339,
                 "image": "http://xxx",
                 "title": "饮食驱宫寒有助女性受孕"
-         }
-        ]  
+          }
+         ]
+       },
+       ……  
    ],
    timeline:[   //每日知识内容（1、备孕状态知识点：优生优育、生男生女、生育政策；2、怀孕状态知识点：发育指标、准爸准妈必读、胎教小课堂；3、育儿状态知识点：发育指标、爸妈必读、早教小课堂。其他内容忽略）
@@ -288 +290 @@
 }}}
 
-==== 3.1周期 ====
+==== 3.2周期 ====
 {{{
   备注：周期
   接口开发：吴全贵
-  请求URL：http://baike.pcbaby.com.cn/intf/app/2.0/week_list_201.jsp // 食谱周期列表
-          http://baike.pcbaby.com.cn/intf/app/2.0/knowledge_week_list_202.jsp //每日知识周期列表
+  请求URL：http://baike.pcbaby.com.cn/intf/app/2.0/week_list_201.jsp // 食谱周期列表（每日食谱周期）
+          http://baike.pcbaby.com.cn/intf/app/2.0/knowledge_week_list_202.jsp //每日知识周期列表（怀孕与育儿状态下的知识周期）
   HTTP请求方式：get
   是否需要登录：否
@@ -303 +305 @@
   返回参数：
   {
-   weeks:[
-    {
-     num:1,
-     tips:"多吃含钙食物"
+    weeks:[ //怀孕周期数据
+      {
+        lemmaId:1, //时间轴id
+        tips:"多吃含钙食物" //专家提示
+      },
+     {
+       lemmaId:2,
+       tips:"多吃含tie食物"
+     }
+   ],
+   babyweeks:[ //宝宝周期数据
+    {
+       lemmaId:41,
+       tips:"多吃含钙食物"
     },
-    {
-     num:1,
+   {
+     lemmaId:42,
      tips:"多吃含tie食物"
-    }
-   ]
-  }
-}}}
-
-==== 3.2食谱列表 ====
+  }
+ ]
+}
+}}}
+
+==== 3.3食谱列表 ====
 {{{
   备注：食谱列表
@@ -331 +343 @@
   返回参数
   {
-   id:
-   cookbook:[
-     [//第一天
-     {
-       id:
-       name:
-       image:
-       des:
-     },
-     {
-       id:
-       name:
-       image:
-       des:
-     }, {
-       id:
-       name:
-       image:
-       des:
-     }
-     
-     ], 
-     [//第二天
-     {
-       id:
-       name:
-       image:
-       des:
-     },
-     {
-       id:
-       name:
-       image:
-       des:
-     }, {
-       id:
-       name:
-       image:
-       des:
-     }
-     ]
-   ]
-  }
-
-}}}
-
-
-==== 3.3食谱详情 ====
+   "id":41 //时间轴id, 41表示第一周宝宝
+   "cookbook":[
+      {
+         "day":"第1天", //一周中的第几天
+         "detail":[
+            {
+               "id":23981, //图片id，这个也是食谱id 
+               "name":"产后第一天膳食安排", //标题
+               "image":"http://xxx", //取的是中图normalUrl的值
+               "des":"对于顺产妈妈" //图片描述
+           }
+           ……
+         ]
+      }
+    ……
+  ]
+}
+}}}
+
+
+==== 3.4食谱详情 ====
 {{{
   备注：食谱详情
@@ -394 +379 @@
  例子：http://pp.pcbaby.com.cn/template/pcbaby/intf/intfGroups4Cookbook.jsp?id=23081&resp_enc=utf-8&req_enc=utf-8
   返回参数
-  {
-   id:
-   name:
-   picDes:[
-    {
-       id:
-       image:
-       des:
-    }
-   ]
-  }
-}}}
-
-
-
-==== 3.2文章搜索（暂不做此功能） ====
+ {
+        "id": 22056, //食谱id
+        "name": "益母木耳汤", //图片名
+        "picDes": [
+           {
+                "des": "这道益母木耳", //图片描述
+                "id": 268101, //图片id
+                "image": "http://xxx " //图片url
+           },
+      ……
+    ]
+}
+}}}
+
+
+==== 3.5文章搜索（暂不做此功能） ====
 {{{
     备注：文章搜索
@@ -447 +432 @@
   缓存方式：有
   缓存时间：1小时
-  请求参数：
-  forums=1;需要查询的版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块
-  noForums=0;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块
-  pickType=pickA;精华类型，可填all,pickA,pickB,pick1,pick2,pick3,pick4,pick5;其中pickA和pickB查的都是普通精华，all为查询所有精华
+
+  请求参数：
+  forums= 1917,2130,1828,1799,1820,2140,1771,1776,2200;需要查询的版块ID，多个版块ID用半角逗号分隔。查找的信息也会包含其子版块 
+     //（说明：潮妈forums参数值固定为1917,2130,1828,1799,1820,2140,1771,1776,2200。其它某个论坛的ID根据列表得到的forums ID传入即可）
+  noForums= 1929;要过滤的版块ID,多个版块ID用半角逗号分隔。查询将过滤掉这些版块及这些版块的子版块（说明：潮妈才需要用到的参数，固定为1929）
+  pickType= pick3;精华类型//剩余type指的是什么呢？（说明：潮妈，pickType为pick3，其它论坛pickType为all）
   pageNo:当前第几页
   pageSize:每页显示的数量，默认为10条
   maxLength:帖子内容需要截取的长度，默认240个字节
-  callback:回调函数
-  showImage=false;显示图片
-  ie=gbk;输出内容的编码格式
-  cacheTime=3600;缓存时间，单位为秒
+  showImage=true;显示图片
+  ie=utf-8;输出内容的编码格式
+  cacheTime=1200;缓存时间，单位为秒
+
   返回参数：
-  {
-   status: 0
-   desc: "查询成功"
-   topics:[
-    {
-       forumId: 版块id
-       forumName: 版块名称
-       topicId: 帖子id
-       title: 帖子标题
-       message: 帖子内容需要截取的长度，默认240个字节
-       authorName: 帖子的用户名
-       createAt: 帖子的创建时间
-       views: 帖子浏览数
-       replyCount: 帖子回复数
-       用户ID（新增）userId
-       用户昵称（新增）userName
-       用户头像（新增）userFaceUrl
-       images[]帖子图片组成的数组（新增，大小为70*70）
-    }
-   ]
-  }
-
+{
+  desc: "查询成功", //状态描述
+  pageNo: 1, //页码
+  pageSize: 20, //每页条数
+  status: 0, //状态码
+  topics: [
+    {
+      createAt: "2015-01-11 19:30:35", //帖子的创建时间
+      forumId: 1917, //版块id
+      forumName: "宝宝秀场", //版块名称
+      images: [ //帖子图片组成的数组
+        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752585_1420975033163_1024x1024.jpg",
+        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752586_1420975112551_1024x1024.jpg",
+        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752588_1420975163834_1024x1024.jpg"
+      ],
+      message: " 《雯雯 萌萌哒》超级可爱的萌妹子，完全可以萌化到心底里...", //帖子内容
+      pickTypes: { //暂无用到参数
+        pick: 2,
+        pick1: 0,
+        pick2: 0,
+        pick3: 1,
+        pick4: 0,
+        pick5: 0
+      },
+      replyCount: 2, //帖子回复数
+      title: "超可爱萌妹子融化人心", //帖子标题
+      topicId: 2155848, //帖子id
+      userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", //用户头像
+      userId: 1265767, //用户ID
+      userName: "啃蘋果的壞蛋", //用户昵称
+      views: 22 //帖子浏览数
+    }
+  ],
+  total: 515 //总帖子数
+}
 }}}
 
@@ -493 +493 @@
   缓存方式：无
   缓存时间：1小时
+
   请求参数：
   fids：指定版块id,多个id用逗号隔开（如：fids=1776,1948,1799,1915）
   pageNo:
   pageSize:
-  ie:产出内容的编码，默认为gbk
+  ie:utf-8 //产出内容的编码，默认为gbk
   maxLength:帖子内容需要截取的长度，默认240个字节
   noFids:需要过滤的版块id，多个id用逗号隔开（如：noFids=1776,1948,1799,1915）注意：该参数只有在fid=1的时候才有效
@@ -503 +504 @@
   返回参数,成功：
 {
-   fids: "1771,1776",
-   topics:[
-  {
-      category: "婆媳",
-      categoryId: 2,
-      createAt: "2014-06-18 14:51:38",
-      floor: 1,
-      forumId: 1771,
-      forumName: "女人心情",
-      forumUrl: "http://localhost.pconline.com.cn/bbs7/forum-1771.html",
-      images: [
-        "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205470_1402557443988_1024x1024.jpeg",
-        "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205471_1402557448357_1024x1024.jpg",
-        "http://dev2.pconline.com.cn:9191/kidsbbs6/1406/12/c0/1205479_1402559413897_1024x1024.png"
+  fids: "1", //版块id
+  pageNo: 1,
+  pageSize: 20,
+  topics: [
+    {
+      category: "原创", //类别
+      categoryId: 0, //类别ID
+      createAt: "2015-01-11 15:17:20", //发帖时间
+      floor: 4, //楼层数
+      forumId: 1799, //版块ID
+      forumName: "晒货殿堂", //版块名称
+      forumUrl: "http://bbs.pcbaby.com.cn/forum-1799.html", //版块URL
+      images: [ //图片数组
+        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c0/1744371_1420960548132_1024x1024.jpg",
+        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c0/1744396_1420960565348_1024x1024.jpg",
+        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c0/1744430_1420960630651_1024x1024.jpg"
       ],
-      lastPostAt: "2014-06-18 14:51:38",
-      message: "修改分类修改分类",
-      replyCount: 0,
-      rewardAmount: 0,
-      rewardRemain: 0,
-      title: "婆媳",
-      topicId: 1942176,
-      topicUrl: "http://localhost.pconline.com.cn/bbs7/topic-1942176.html",
-      userId: 826717,
-      userName: "MyNameIsSoLongAndBig",
-      userUrl: "http://my.pcbaby.com.cn/id/826717/bbs/",
-      viewCount: 1，
-      用户头像（新增，大小为46*46） userFaceUrl    
-    }
-   ]
-  }
- 
-}}}
+      lastPostAt: "2015-01-11 21:49:58", //最后回帖时间
+      message: "金币兑换的活动被我赶上好时候了。", //内容
+      replyCount: 3, //回复数
+      rewardAmount: 0, //未使用参数
+      rewardRemain: 0, //未使用参数
+      title: "【金币兑换】终于收到宝贝与我！", //标题
+      topicId: 2155710, //帖子ID
+      topicUrl: "http://bbs.pcbaby.com.cn/topic-2155710.html", //帖子URL
+      userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/25/23/72/54/25237254_50x50", //用户头像
+      userId: 25237254, //用户ID
+      userName: "馨悦妈妈", //用户昵称
+      userUrl: "http://my.pcbaby.com.cn/id/25237254/bbs/", //用户URL
+      viewCount: 20 //帖子查看数
+    }
+  ],
+  total: 639 //总条数
+}
+
+}}}
+
 ==== 4.2生活圈栏目列表 ====
 {{{
@@ -565 +570 @@
   备注:获取帖子内容
   接口开发：mrobot
-  请求URL:http://mrobot.pcbaby.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18&is_1tai=1
+  请求URL:http://mrobot.pcbaby.com.cn/v2/bbs/topics/2155848?pageNo=1&size=17&picRule=2
   HTTP请求方式：get
   是否需要登录：否
@@ -572 +577 @@
   缓存时间：无
   请求参数：
-  tid:4592911
-  pageNo：页码
-  pageSize：一页条数
-  is_1tai：值为1时，表示请求1胎帖子终端且图片点击增加协议（协议与pcauto一样）。
+  /topics/2149994：帖子id；
+  size：帖子内容字体大小；
+  pageNo：当前所在页数；
+  picRule：图片默认显示规则，0为显示小图，1为显示文字链接；2为显示大图。
   设置header  Cookie = "common_session_id=xxxx";
+
   返回参数
   加入一段注释，注释内的内容为一段json
   /*@_HTML_META_START_
-  {"favoriteId":-1,"pageCount":5,"pageNo":1,"title":"3月6日北京提2012款白色三厢2.0AT旗舰型作业","userId":32031278,"webUrl":"http://bbs.pcauto.com.cn/topic-4592911.html"}
+ {
+  "countAndroid":5772,
+  "countIphone":5768,
+  "pageCount":1,
+  "pageNo":1,
+  "title":"超可爱萌妹子融化人心",
+  "userId":1265767,"webUrl":"http://bbs.pcbaby.com.cn/topic-2155848.html"
+ }
   _HTML_META_END_@*/
-  
-  点击图片，要有对应协议，可以参考接口：
-  http://mrobot.pcauto.com.cn/v2/bbs/topics/4592911?pageNo=1&pageSize=19&picRule=2&authorId=0&topicTemplate=4.0.0&app=pcautobrowser&size=18
-  
-  
-  url:http://piebbs.pconline.com.cn/rest/topics/${topicId}
+
 }}}
 
@@ -607 +615 @@
   
   返回参数
-  {
-    msg:
-    result
-  }
+  帖成功，返回HTTP响应头为201，即内容创建成功
+{
+  "Location": "http://bbs.pcbaby.com.cn/topic-2156187.html", //帖子URL
+  "goldCount": 1, //发帖获得金币数量
+  "hasGold": true //发帖是否获得金币
+}
+
 }}}
 
@@ -624 +635 @@
   replyToId：回复楼层的id
   设置header  Cookie = "common_session_id=xxxx";
-
-  说明:POST
+  （说明：“common_session_id=F7944998D4C5E2F849C085976791BE51FA2F3CE3A5F6D159”是用户登录后得到的身份ID。大部分需要以登录身份操作的接口都需要将该值作为请求HTTP头中的Cookie值传入）
 
   发帖成功，返回HTTP响应头为201，即内容创建成功
@@ -631 +641 @@
   返回参数
   {
-   msg:
-   result:
-  }
+     "Location": "http://bbs.pcbaby.com.cn/post-2156187_39095567.html"
+  }
+
 }}}
 
 ==== 4.6上传图片 ====
 {{{
-  备注:上传图片
+  备注:上传图片,返回json数据有多张不同尺寸大小的图片，可根据业务需求选择使用
   接口开发：
-  请求URL：http://upc.pconline.com.cn/upload_quick.jsp?application=yidong
+  请求URL：http://upc.pcbaby.com.cn/upload_quick.jsp?command=6004&command=6005&command=6006&command=4&keepSrc=yes&application=kidsbbs6
   HTTP请求方式：post
   是否需要登录：是
@@ -648 +658 @@
   请求参数：
   file：文件名称，文件本体
-  富文本格式传送,该接口返回图片url，其被用于回帖或者发帖中贴图。  
+    富文本格式传送,该接口返回图片url，其被用于回帖或者发帖中贴图。
+  设置header  Cookie = "common_session_id=xxxx";  
+
+  返回参数：
+{
+  "files": [
+    {
+      "fileSize": 4368, //文件大小
+      "exif": "", //exif信息
+      "height": 80, //图片宽度
+      "rid": 9990346, //未使用参数
+      "width": 120, //图片宽度
+      "fileName": "1780739_1421043128740_120x80.jpg", //文件名
+      "audit": "New", //未使用参数
+      "orgFileName": "test.jpg", //未使用参数
+      "isorg": 0, //未使用参数
+      "url": "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/12/c0/1780739_1421043128740_120x80.jpg" //图片URL
+    }
+  ],
+  "retCode": 0, //状态码
+  "tid": 1780739 //未使用参数
+}
 }}}