Changes between Version 2 and Version 3 of baby3.0_developers/interface


Ignore:
Timestamp:
02/19/2016 02:40:18 PM (10 years ago)
Author:
zengwenjie
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • baby3.0_developers/interface

    v2 v3  
    5050 || lemmaId ||int ||是 ||时间轴id） || 
    5151 || agent ||int ||是 ||客户端标识，IOS:2,Android:3） || 
     52 || month ||int ||是 ||//怀孕、育儿所在阶段的第几个月，例如，育儿第一个月month=1，当育儿1~6的时候month=13） || 
    5253 
    5354{{{ 
    … …  
    7172//新增推荐位,根据时间节点一天返回3套数据，一套3条数据 
    7273 "recommendTimeline": [ 
    73 { 
    74         "index": [ 
     74[ 
    7575            { 
    7676                "content": "新生儿一天要睡20-22个小时，脸上还会有不同的表情。", 
    77                 "description": "\n出生后,在这期间大约有9-10个小时是浅睡眠状态,因而新生儿睡觉大多不踏实。", 
    7877                "id": 15403, 
    7978                "image": "http://www1.pcbaby.com.cn/baby/4.jpg", 
    … …  
    8180                "type": 内容类型（type=1 图集，type=2 视频，type=3 专家视点，type=4 问答专栏（已去除），type=5 精彩活动，type=6 资讯文章，type=7 百科文章，type=8 生活圈帖子，type=9 私密圈帖子，type=10 html页） 
    8281 
    83             } 
    84         ], 
    85         "point": [ 
     82            }, 
    8683            { 
    8784                "content": "物理按摩、中药、快速下奶。", 
    88                 "description": "对新妈妈来豆味。杂粮粥营养价值高，不仅可以补养身体，还可以促进乳汁分泌。", 
    8985                "id": 15775, 
    9086                "title": "吃什么下奶", 
    … …  
    9389            { 
    9490                "content": "新生儿吐奶后，妈妈要把他要减少到平时的一半，缓解吐奶症状。", 
    95                 "description": "吐奶是新生儿的常见现象，，也可能是身查明原因。", 
    9691                "id": 16147, 
    9792                "title": "新生儿吐奶怎么办", 
    9893                "type": "11" 
    9994            } 
    100         ] 
    101     },     
    102 { 
    103  
    104 }, 
    105 { 
    106  
    107 } 
    108  
     95    ],     
     96...... 
     97...... 
    10998  ], 
    11099 
    111100 "timeline": { 
    112 //1-2岁每日知识内容，根据时间轴id,一次性返回7条数据（1-12个月，每个月返回的7条数据都不同）； 
    113 //2-6岁每日知识内容，根据时间轴id,一次性返回7条数据（2-6岁，每年返回7条数据） 
    114 //0-1岁保持原来的，每天返回一条数据（兼容旧版本） 
    115  
    116     "point": [ 
    117       [ //知识点概括 
    118         { 
    119              "content": "现在子宫和胎盘一直挤压我的小脸。", 
    120              "description": "进入孕后期", 
    121              "id": 511, 
    122              "title": "孕妇尿频", 
    123              "type": "11" 
    124         }, 
    125         { 
    126              "content": "现在子宫和胎盘一直挤压我的小脸。",             "description": "孕期气短通常没有什么大碍。", 
    127              "id": 633, 
    128              "title": "孕妇气短", 
    129              "type": "11" 
    130         } 
    131       ], 
    132      [ //知识点概括 
    133         { 
    134              "content": "现在子宫和胎盘一直挤压我的小脸。", 
    135              "description": "进入孕后期。", 
    136              "id": 511, 
    137              "title": "孕妇尿频", 
    138              "type": "11" 
    139         }, 
    140         { 
    141              "content": "现在子宫", 
    142              "description": "孕期气短通常没有什么大碍。", 
    143              "id": 633, 
    144              "title": "孕妇气短", 
    145              "type": "11" 
    146         } 
    147       ] 
    148    ] 
    149101  }, 
    150102  recommendChannel:[ //热门栏目 
    151    { 
    152      title:  //根据栏目名称跳转至对应模块 
    153      type:  //热门栏目类型（type＝5表示家庭育儿） 
    154             //type=1 阅读，type=2 百科，type=3 交流圈，type=4 每日知识，type=5 家庭育儿，type=6 问答，type=7 活动，type=8 工具，type=9 每日食谱     
    155    } 
    156103  ], 
    157104 recommendContent: （推荐位） 
    … …  
    160107//（0-1岁育儿，跟旧版保持不变，每天返回一条数据，考虑旧版本兼容） 
    161108[  
    162    { 
    163      type:1 //类型：图集；内容类型（type=1 图集，type=2 视频，type=3 专家视点，type=4 问答专栏（已去除），type=5 精彩活动，type=6 资讯文章，type=7 百科文章，type=8 生活圈帖子，type=9 私密圈帖子，type=10 html页） 
    164      image: //图片url 
    165      title: //标题 
    166      imageCount:13 //图集总数 
    167      albumsId:  //图集id 
    168      label:"宝宝护理" //图集标签 
    169    }, 
    170    { 
    171      type:2 //类型：视频 
    172      image: //图片url 
    173      title: //标题 
    174      preview:"孩子经常发烧" //简介  
    175      articleId: "2042246", //文章id 
    176      videoId: "2006"， //视频id 
    177    }, 
    178    { 
    179      type:3 //类型：专家视点 
    180      image: //图片url 
    181      title: //标题 
    182      url:  //专家视点页面url 
    183      expertName: //专家名 
    184      position:"副主任医师" //职位 
    185      department: "儿科"， //科室 
    186      id:  //视点文章id 
    187   } 
    188109 ], 
    189110 topics:[ //精彩话题（生活圈与私密圈帖子一共出5条数据，两者出现的顺序与数目不固定，但总数目不变：5条） 
    190111（每日更新内容，不以时间节点为单位） 
    191    { //生活圈帖子 
    192      createAt: "2015-01-11 19:30:35", //帖子的创建时间 
    193      images: [ //帖子图片组成的数组 
    194        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752585_1420975033163_1024x1024.jpg", 
    195        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752586_1420975112551_1024x1024.jpg", 
    196        "http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752588_1420975163834_1024x1024.jpg" 
    197      ], 
    198      image："http://img.pcbaby.com.cn/images/upload/upc/tx/kidsbbs6/1501/11/c1/1752585_1420975033163_1024x1024.jpg",//帖子导读图或第一张图 
    199      isSecret: false, //是否私密贴（false 生活贴；true 私密贴） 
    200      title: "超可爱萌妹子融化人心", //帖子标题 
    201      message: " 《雯雯 萌萌哒》超级可爱的萌妹子，完全可以萌化到心底里...", //帖子内容 
    202      topicId: 2155848, //帖子id 
    203      userFaceUrl: "http://i1.3conline.com/images/upload/upc/face/12/65/76/7/1265767_70x70", //用户头像 
    204      userId: 1265767, //用户ID 
    205      userName: "啃蘋果的壞蛋", //用户昵称 
    206      viewCount: 22, //帖子浏览数 
    207      replyCount: 2, //帖子回复数 
    208    } 
    209    ... 
    210    {  //私密圈帖子 
    211      topicId: 2156386,          //帖子ID 
    212      isSecret: true, //是否私密贴（false 生活贴；true 私密贴） 
    213      title: "最难忘前任的那点",    //标题 
    214      message: "最难忘前任的那点", //帖子内容 
    215      createAt: "2015-01-12 14:34:15",    //发帖时间 
    216      viewCount: 2,  //帖子浏览数  
    217      replyCount: 0,  //帖子回复数 
    218    } 
    219    ... 
     112    
    220113 ] 
    221114 topFocus: [ //焦点图广告 
    … …  
    239132 >验证序列号是否有效接口 
    240133 **开发人员：** 
    241  >李峰 
     134 >后端 
    242135 ** HTTP请求方式：** 
    243136 >post 
    … …  
    268161==  3.激活设备序列号:== 
    269162  **开发人员** 
    270   >（ 李峰） 
     163  >（ 后端） 
    271164  **HTTP请求方式：** 
    272165  >post 
    … …  
    298191== 4.找回序列号: == 
    299192  **开发人员** 
    300   >（ 李峰） 
     193  >（ 后端） 
    301194  **HTTP请求方式：** 
    302195  >post 
    … …  
    325218}}} 
    326219 
    327 == 5. 保存（备份）记录 (后端，要参考快妈接口 ):== 
    328   **开发人员** 
    329   >（ 李峰） 
     220== 5.获取手机验证码接口: == 
     221  **开发人员** 
     222  >（ 后端） 
     223  **HTTP请求方式：** 
     224  >post 
     225  **是否需要登录：** 
     226  >是 
     227  **返回格式：** 
     228  >JSON 
     229  **缓存方式：** 
     230  >无 
     231  **缓存时间：** 
     232  >无 
     233  **请求参数：** 
     234 ||参数名||类型||必须||说明|| 
     235 || phone_number ||string ||是 ||手机号|| 
     236 
     237{{{ 
     238  返回参数: 
     239{ 
     240        “status”：0,                     //处理状态 
     241        “message”：”用户操作成功”,     //相关状态信息 
     242        “verify_code”:”123456”          //客户端用于校验的验证码，格式为6位随机数字 
     243} 
     244 
     245}}} 
     246 
     247 
     248== 6. 保存（备份）体重秤记录 (后端，要参考快妈接口 ):== 
     249  **开发人员** 
     250  >（ 后端） 
    330251  **HTTP请求方式：** 
    331252  >post 
    … …  
    359280}}} 
    360281 
    361 == 6. 体重分析wap页面: == 
     282== 7. 删除体重秤接口: == 
     283  **开发人员** 
     284  >（ 后端） 
     285  **HTTP请求方式：** 
     286  >post 
     287  **是否需要登录：** 
     288  >是 
     289  **返回格式：** 
     290  >JSON 
     291  **缓存方式：** 
     292  >无 
     293  **缓存时间：** 
     294  >无 
     295  **请求参数：** 
     296 ||参数名||类型||必须||说明|| 
     297 || common_session_id ||string ||是 ||用户id|| 
     298 || lemanId ||iny||是 ||时间轴id|| 
     299 || date ||string ||是 ||当天日期（2016-05-02）|| 
     300 
     301{{{ 
     302  返回参数: 
     303{ 
     304    status:”0”(0代表正常，-1代表异常) 
     305   message:”删除成功” 
     306} 
     307}}} 
     308 
     309== 8. 体重分析wap页面: == 
    362310  **开发人员** 
    363311  >mrobot，制作 
    … …  
    379327 || weight ||float ||是 ||当前体重|| 
    380328 || date ||string ||是 ||当天日期（2016-05-02）|| 
    381  
    382 == 7. 上传胎心记录接口: == 
    383   **开发人员** 
    384   >（ 李峰） 
    385   **HTTP请求方式：** 
    386   >post 
    387   **是否需要登录：** 
    388   >是 
    389   **返回格式：** 
    390   >JSON 
    391   **缓存方式：** 
    392   >无 
    393   **缓存时间：** 
    394   >无 
    395   **请求参数：** 
    396  ||参数名||类型||必须||说明|| 
    397  || common_session_id ||string ||是 ||用户id|| 
    398  || averageRate ||int ||是 ||平均心率|| 
    399  || recodeTime ||string ||是 ||录制时长|| 
    400  || lemenId ||int ||是 ||时间轴id|| 
    401  || weight ||float ||是 ||当前体重|| 
    402  || recodeData ||data ||是 ||音频文件|| 
    403  || date ||string ||是 ||2013-8-3 15:30:25（精确到秒）|| 
     329 || BMIType ||int ||是 ||BMI指数类型（4孕前正常，5孕前偏瘦，6孕前偏重，7孕前超重)|| 
     330 || week ||int ||是 ||怀孕第几周，如week=16为怀孕第16周|| 
     331 ||weightRange ||string ||是 ||建议的标准体重（51~59）|| 
     332 ||isBabyWeight ||string ||是 ||是否为宝宝体重，isBabyWeight=1为宝宝体重|| 
     333 
     334== 9. 胎语仪分享页: == 
     335  **开发人员** 
     336  >（ 烧饭） 
     337  **HTTP请求方式：** 
     338  >post 
     339  **是否需要登录：** 
     340  >是 
     341  **返回格式：** 
     342  >JSON 
     343  **缓存方式：** 
     344  >无 
     345  **缓存时间：** 
     346  >无 
     347  **请求参数：** 
     348 ||参数名||类型||必须||说明|| 
     349 || common_session_id ||string ||是 ||用户id|| 
     350 || date ||string ||是 ||123456（时间戳）|| 
    404351 
    405352{{{ 
    … …  
    407354{ 
    408355    “status”：0,（0代表成功，-1代表失败）   //处理状态 
    409   “message”： （描述信息）, 
    410 } 
    411  
    412 }}} 
    413  
    414 == 8. 获取孕周和体重记录: == 
     356    "url": "音频url", 
     357} 
     358 
     359}}} 
     360 
     361== 10. 删除胎语音频接口: == 
     362  **开发人员** 
     363  >（后端，UPA） 
     364  **HTTP请求方式：** 
     365  >post 
     366  **是否需要登录：** 
     367  >是 
     368  **返回格式：** 
     369  >JSON 
     370  **缓存方式：** 
     371  >无 
     372  **缓存时间：** 
     373  >无 
     374  **请求参数：** 
     375 ||参数名||类型||必须||说明|| 
     376 || common_session_id ||string ||是 ||用户id|| 
     377 || record_time ||string ||是 ||123456（时间戳）|| 
     378 
     379{{{ 
     380  返回参数: 
     381{ 
     382    status:”0”(0代表正常，-1代表异常)， 
     383   message:”删除成功” 
     384} 
     385 
     386}}} 
     387 
     388 
     389== 11. 上传胎语音频文件接口: == 
     390  **开发人员** 
     391  >（ UPA） 
     392  **HTTP请求方式：** 
     393  >post 
     394  **是否需要登录：** 
     395  >是 
     396  **返回格式：** 
     397  >JSON 
     398  **缓存方式：** 
     399  >无 
     400  **缓存时间：** 
     401  >无 
     402  **请求参数：** 
     403 ||参数名||类型||必须||说明|| 
     404 || common_session_id ||string ||是 ||用户id|| 
     405 || upload_file ||string ||是 ||音频文件路径（必须在post form中）|| 
     406 ||recTime ||int ||是 ||记录时间（时间戳）|| 
     407 
     408{{{ 
     409  返回参数: 
     410{ 
     411         “status”：0,                    //处理状态 
     412        “message”：”OK”,                 //相关状态信息 
     413        “file_url”:”test.icarenewlife.com/abcd” //音频URL（只有status=0时才有值） 
     414} 
     415 
     416}}} 
     417 
     418== 12. 上传（备份）胎语记录数据接口 == 
     419  **开发人员** 
     420  >（ 后端） 
     421  **HTTP请求方式：** 
     422  >post 
     423  **是否需要登录：** 
     424  >是 
     425  **返回格式：** 
     426  >JSON 
     427  **缓存方式：** 
     428  >无 
     429  **缓存时间：** 
     430  >无 
     431  **请求参数：** 
     432 ||参数名||类型||必须||说明|| 
     433 || common_session_id ||string ||是 ||用户id|| 
     434 {{{ 
     435   请求参数： 
     436    record_data_array：（用户记录数据集，Json数组格式） 
     437[ 
     438{//一条记录格式 
     439 
     440        //公共项 
     441        recTime:                                // 记录时间（时间戳） 
     442        occurTime:                              // 发生时间（时间戳） 
     443        recType:                                // 记录类型 
     444        comments:                               // 备注 
     445   file_url：                      // 音频文件url 
     446                 upload_category：          //  指定上传操作种类（1胎心，23成人心跳） 
     447 
     448       sequence_no;        // 上传文件序列号（胎语默认设为1） 
     449 
     450 
     451        //胎语 
     452        avgRate_fetalBeat:                      // 平均心率 
     453        duration_fetalBeat:                     // 时长 
     454        beatValue_fetalBeat:            // 胎心数据 
     455        beatTime_fetalBeat:                     // 对应胎心数据的时间, 单位为秒 
     456        tagTime_fetalBeat:                      // 胎心时间 单位为秒 
     457//成人心跳 
     458        avgRate_adultBeat:                      // 平均心率 
     459        duration_adultBeat:                     // 时长 
     460        beatValue_adultBeat:            // 胎心数据 
     461        beatTime_adultBeat:                     // 对应胎心数据的时间, 单位为秒 
     462        tagTime_adultBeat:                      // 成人心跳时间 单位为秒 
     463} 
     464…. 
     465] 
     466 
     467}}} 
     468 
     469{{{ 
     470  返回结果: 
     471{ 
     472    “status”：0,                                 //处理状态 
     473        “message”：”OK”,                         //相关状态信息 
     474        “upload_success_count”：100,             //上传成功记录条数 
     475        “upload_success_array”:                 //上传成功数据的记录类型和记录时间数组 
     476                 [ 
     477                        { 
     478                                "recTime": “148959560000”,      //记录时间 
     479                "recType": "1",                 //记录类型 
     480                        } 
     481                         
     482                ... 
     483                ]                
     484} 
     485 
     486}}} 
     487 
     488== 13. 下载胎心音频文件接口: == 
     489  **开发人员** 
     490  >（ 后端） 
     491  **HTTP请求方式：** 
     492  >post 
     493  **是否需要登录：** 
     494  >是 
     495  **返回格式：** 
     496  >JSON 
     497  **缓存方式：** 
     498  >无 
     499  **缓存时间：** 
     500  >无 
     501  **请求参数：** 
     502 ||参数名||类型||必须||说明|| 
     503 || common_session_id ||string ||是 ||用户id|| 
     504 || record_type ||string ||是 || 用户记录类型(胎语默认为1) || 
     505 ||recTime ||int ||是 ||记录时间（时间戳）|| 
     506 
     507{{{ 
     508  返回参数: 
     509{ 
     510        "status"：0,                                     //处理状态 
     511        "message"："OK",                         //相关状态信息 
     512        "download_record_data": 
     513           { 
     514        //公共项 
     515        recTime:                                        // 记录时间 
     516        occurTime:                                      // 发生时间 
     517        recType:                                        // 记录类型 
     518        comments:                                       // 备注 
     519        //胎语 
     520        avgRate_fetalBeat:                      // 平均心率 
     521        duration_fetalBeat:                     // 时长 
     522        beatValue_fetalBeat:            // 胎心数据 
     523        beatTime_fetalBeat:                     // 对应胎心数据的时间, 单位为秒 
     524        tagTime_fetalBeat:                      // 胎心时间 单位为秒 
     525        audioPath_fetalBeat:            // 胎心音频路径 
     526 
     527//成人心跳 
     528        avgRate_adultBeat:                      // 平均心率 
     529        duration_adultBeat:                     // 时长 
     530        beatValue_adultBeat:            // 胎心数据 
     531        beatTime_adultBeat:                     // 对应胎心数据的时间, 单位为秒 
     532        tagTime_adultBeat:                      // 成人心跳时间 单位为秒 
     533 audioPath_adultBeat:           // 成人心跳音频路径 
     534 
     535} 
     536} 
     537 
     538}}} 
     539 
     540== 14. 获取孕周和体重记录: == 
    415541  **开发人员** 
    416542  >mrobot ,李峰 
    … …  
    438564            { 
    439565                  "lemmaId": 281, //时间节点id 
    440                   “date”:2016-05-01, 
     566          “date”:2016-05-01, 
    441567                     "weight": 58.0, // 体重 
    442                       “desc” :”偏重” 
     568          “desc” :”偏重” 
    443569            }, 
    444570            { 
    445571                    "lemmaId": 282, //时间节点id 
    446                   “date”:2016-05-01, 
     572          “date”:2016-05-01, 
    447573                    "weight": 59.0 // 体重 
    448                      “desc” :”偏轻” 
    449             } 
     574          “desc” :”偏轻” 
     575          } 
    450576            ... 
    451577         ] 
    … …  
    454580}}} 
    455581 
    456 == 9. 胎语纪录分析页，推荐内容接口: == 
     582== 15. 胎语纪录分析页，推荐内容接口: == 
    457583  **开发人员** 
    458584  >mrobot ,制作 
    … …  
    476602{ 
    477603  status : (0代表正常，-1代表异常) 
    478 data:[ 
     604 data:[ 
     605  { 
     606       articleId:198 //文章id 
     607       imgUrl:”文章导读图”, 
     608       title:”宝宝心跳，带给孕妈的感动”, 
     609       desc: “描述” 
     610  }, 
     611  { 
     612      qId:200 //问答id 
     613      title: “忽略4件事 胎儿小心脏或有缺陷” 
     614  }, 
    479615 { 
    480    id:”198”, 
    481    imgUrl:””, 
    482    title:”宝宝心跳，带给孕妈的感动”, 
    483   desc: “” 
    484  }, 
    485  { 
    486   id:201 
    487   title: “” 
    488  }, 
    489  { 
    490   id:202 
    491   title:”” 
     616      qId:201 //问答id 
     617      title: “胎儿性别早知道 从胎心看男女” 
    492618 } 
    493619 ] 
    494  } 
    495 }}} 
    496  
    497 == 10.获取我的记录接口: == 
     620} 
     621 
     622}}} 
     623 
     624== 16.获取我的记录接口: == 
    498625  **开发人员** 
    499626  >mrobot ,李锋 
    … …  
    511638 ||参数名||类型||必须||说明|| 
    512639 || common_session_id ||string ||是 ||用户id|| 
    513  ||  v  ||string ||不是 ||版本号（300）|| 
    514640 
    515641{{{ 
    … …  
    522648      "data": “2016-2-2”, 
    523649      "weight": "59.0kg", 
    524       "weightState": "体重正常", 
    525650      "tip": “专家提醒：良好的生活习惯继续保持。进行有效的锻炼，有助于孕妇控制体重", 
    526       time:”2016-2-15 15:30:25” (保存胎语记录时间) 
     651      recordTime:”1432579845” (保存胎语记录时间,时间戳) 
    527652      "heartBeat": “110～160次/分”,（怀孕阶段才出来） 
    528653       “babyWeight” : 10 (婴儿体重) 
    529        “babyState” :   “正常体重” 
    530       "heartState": “正常"  
     654      "babyTip": “专家提醒：良好的生活习惯继续保持。进行有效的锻炼，有助于孕妇控制体重" 
    531655    }, 
    532656    { 
    533657      "data": “2016-2-2”, 
    534658      "weight": "59.0kg", 
    535       "weightState": "体重正常", 
    536659      "tip": “专家提醒：良好的生活习惯继续保持。进行有效的锻炼，有助于孕妇控制体重", 
    537        time:”2016-2-15 15:30:25” (保存胎语记录时间) 
     660       recordTime:”1432579845” (保存胎语记录时间,时间戳) 
    538661      "heartBeat": “110～160次/分", 
    539        “babyWeight” : 10 (婴儿体重) 
    540        “babyState” :   “正常体重” 
    541       "heartState": "正常" 
     662      “babyWeight” : 10 (婴儿体重) 
     663     "babyTip": “专家提醒：良好的生活习惯继续保持。进行有效的锻炼，有助于孕妇控制体重" 
    542664} 
    543665......