[[TOC]]

== 杂志相关接口 ==
== 1.基本约定 ==
{{{
通用接口请求参数:
req_enc=utf-8           请求参数编码
resp_enc=utf-8          响应返回编码
common_session_id=xxxx      用户登录凭证,如果接口需要登陆则生效
pageNo=1          请求页码(>=1),如果接口返回有分页处理则生效
pageSize=20         请求页长度,默认20,如果接口返回有分页处理则生效

通用接口返回参数:
total:18            返回记录总条数,如果接口返回有分页处理则生效
pageNo:1            返回页码(>=1),如果接口返回有分页处理则生效
pageSize:20         返回页长度,如果接口返回有分页处理则生效

名词解释
接口URL:   接口URL
接口说明: 描述接口的应用场景
请求参数：参数名=xxx
是否登录：是|否,表示接口是否要登陆才能访问
是否分页:  是|否,表示返回的列表有分页处理
缓存时间：xx,设置Response Http Headers Cache-Control:max-age=xx(单位/秒)
返回结果：成功返回结果示例

全局接口返回格式：json
}}}
== 2.汽车.时尚.家居相似接口 ==
=== 2.1 热搜词 ===
请求接口：[[BR]]
汽车iPad：http://mrobot.pcauto.com.cn/configs/pcauto_magazine_hotwords [[BR]]
汽车iPhone：http://mrobot.pcauto.com.cn/configs/pcauto_iphone_magazine_hotwords [[BR]]
家居iPad：http://mrobot.pchouse.com.cn/configs/pchouse_magazine_hotwords [[BR]]
家居iPhone：http://mrobot.pchouse.com.cn/configs/pchouse_iphone_magazine_hotwords [[BR]]
时尚iPad：http://mrobot.pclady.com.cn/configs/pclady_magazine_hotwords [[BR]]
时尚iPhone：http://mrobot.pclady.com.cn/configs/pclady_iphone_magazine_hotwords [[BR]]

返回结果：[[BR]]
{{{
  {
    "list": [
        {
            "v": "小户型"
        },
        {
            "v": "简约"
        },
        {
            "v": "沙发"
        },
        {
            "v": "卫浴空间"
        },
        {
            "v": "客厅"
        },
        {
            "v": "设计师"
        }
    ]
}
}}}
=== 2.2 banner广告 ===
请求接口：[[BR]]

汽车iPad：http://mrobot.pcauto.com.cn/configs/pcauto_magazine_ads [[BR]]
汽车iPhone：http://mrobot.pcauto.com.cn/configs/pcauto_iphone_magazine_ads [[BR]]
家居iPad：http://mrobot.pcauto.com.cn/configs/pchouse_magazine_ads [[BR]]
家居iPhone：http://mrobot.pcauto.com.cn/configs/pchouse_iphone_magazine_ads [[BR]]
时尚iPad：http://mrobot.pcauto.com.cn/configs/pclady_magazine_ads [[BR]]
时尚iPhone：http://mrobot.pcauto.com.cn/configs/pclady_iphone_magazine_ads [[BR]]

返回结果：[[BR]]
{{{
  {
    "ads": [
        {
            "id": "101",
            "location": "1",
            "duration": "4",
            "srci4": "http://www1.pchouse.com.cn/pchouse20150120qidongtu-i4.png",
            "srci5": "http://www1.pchouse.com.cn/pchouse20150120qidongtu-i5.png",
            "srci6": "http://www1.pchouse.com.cn/pchouse20150120qidongtu-i6.png",
            "srci6p": "http://www1.pchouse.com.cn/pchouse20150120qidongtu-i6p.png",
            "pv-link": "",
            "begin": "2015-02-15 00:00:00",
            "end": "2015-02-26 00:00:00"
        },
        {
            "id": "102",
            "location": "2",
            "type": "1",
            "src": "http://www1.pchouse.com.cn/498-126-quanzi.jpg", //图片的链接
            "src3x": "",
            "link": "http://itunes.apple.com/cn/app/jia-ju-za-zhi/id543134887?mt=8", //点击图片跳转到appStroe
            "pv-link": "",
            "begin": "2014-12-16 00:00:00",
            "end": "2015-12-31 00:00:00"
        }
    ],
    "beta": [
        {
            "show": "0",
            "link": "https://m.pc.com.cn"
        }
    ],
    "recommendApp": [
        {
            "show": "1"  //控制是否显示横幅下面的推荐杂志链接，同时也用来控制版本更新按钮的隐藏
        }
    ]
}
}}}
== 3.汽车杂志接口 ==
== 4.时尚杂志接口 ==
== 5.家居杂志接口 ==
=== 5.1 [=#point5.1 资讯首页] ===
[[BR]]mrobot接口:http://mrobot.pchouse.com.cn/v3/cms/index?deviceType=ipad2&pageNo=1&pageSize=20
[[BR]]后台接口:http://www.pchouse.com.cn/app/4json/
[[BR]]后台接口:http://192.168.11.20:8888/magazine/publish/ipad2/json/magazines.json
[[BR]]HTTP请求方式:get
[[BR]]是否需要登录:false
[[BR]]返回格式:json
[[BR]]缓存时间:1小时
[[BR]]是否分页：是
[[BR]]请求参数:[[BR]]
||参数名||类型||必须||说明||
||deviceType||String||必填||设备类型:ipad2,ipad3,iphone4,iphone5,android||
||pageNo||int||可选||页码(默认为1)||
||pageSize||int||可选||每页大小（默认为20）||
[[BR]]返回数据结构
{{{
{
focus: [
{
image: "http://img0.pchouse.com.cn/pchouse/test/lf/02/1506/Hydrangeas_1.jpg",
url: "http://www.pchouse.com.cn/test/lf/02/1206/210452.html"
}
...
],
inforData: [
{
articleId: "771951",
articleUrl: "http://m.pchouse.com.cn/x/77/771951.html",
imageUrl: "http://img0.pchouse.com.cn/pchouse/test/lf/1506/Chrysanthemum.jpg",
pubDate: "2015-06-05",
title: "打造春季婚房上海夫妻21万装98平清单",
type: "1"
}
...
],
latestPeriodical: {
base_url: "http://reader.pchouse.com.cn/pchousemag/ipad2/seperatepack/610/610-base.zip",
base_url_prefix: "http://reader.pchouse.com.cn/pchousemag/ipad2/seperatepack/610/",
bestTopicUrl: "",
bookDownloadStatus: "1",
cover: "http://reader.pchouse.com.cn/pchousemag/ipad2/cover/610-big.jpg?201506011707",
deviceType: "0",
dir-ver: "http://reader.pchouse.com.cn/pchousemag/ipad2/content/610-ver-dir.jpg",
id: "610",
issue: "6月刊",
magazine: "PChouse",
md5: "abf2e13b3d7f1d7e429f60003e7e85b4",
publishTime: "2015-06-01 17:07:48",
publisher: "家居网",
size: "139.82MB",
summary: "谁说大孩子就没有儿童节。来看本期专题，儿童房与宝贝一同成长。帮你解决熊孩子的收纳问题，为心中的Angel制造一个甜美童年。杂志君还手把手教你挑选儿童房壁纸，包你过足眼瘾。现关注微信，可以了解更多美家方案！还有机会获得手机充值卡哦~祝大家儿童节快乐！Enjoy！",
thumb: "http://reader.pchouse.com.cn/pchousemag/ipad2/cover/610-small.jpg?201506011707",
url: "http://reader.pchouse.com.cn/pchousemag/ipad2/610.zip",
volume: "0"
},
pageNo: 1,
pageSize: 4,
total: 4
}
}}}
说明：focus为焦点图，latestPeriodical为最新刊，inforData为资讯列表。[[BR]]
资讯文章有4种类型：[[BR]]
文章类：type=1；[[BR]]
图集类：type=2 类型，albumsId=xx 图集id，count=xx 图片总数；[[BR]]
广告专题：type=3 类型；topicId=xx 广告专题id；logoUrl=xx 公司logo链接；companyName=xx 公司名称；companyDesc=xx 公司描述；[[BR]]
商品：type=4 类型；goodsId=xx 商品id

== 6.杂志跳转协议 ==
[[http://trac.pc.com.cn/magazine-ios/wiki/api | 跳转协议列表]]