Git@OSC 项目推荐 —— 知乎日报客户端 Swift

API 说明

• 知乎日报的消息以 JSON 格式输出
• 网址中 api 后数字代表 API 版本，过高或过低均会得到错误信息
• 较老的接口（启动界面图像获取，最新消息，过往消息）中将数字 2 替换为 1.2 获得效果相同，替换为 1.1 获得的是老版本 API 输出的 JSON 格式（替换为更低，如 1.0，或更高，如 1.3，将会获得错误消息）
• 以下所有 API 使用的 HTTP Method 均为 GET

API 分析

1. 启动界面图像获取

• URL: http://news-at.zhihu.com/api/4/start-image/{aspec}
• start-image 后为图像分辨率，接受如下格式
  • 320*432
  • 480*728
  • 720*1184
  • 1080*1776
• 响应实例:

{     text: "© Fido Dido",     img: "http://p2.zhimg.com/10/7b/107bb4894b46d75a892da6fa80ef504a.jpg"     }  

• 分析:

2. 软件版本查询

• Android: http://news-at.zhihu.com/api/4/version/android/2.3.0
• IOS: http://news-at.zhihu.com/api/4/version/ios/{version}
• URL 最后部分的数字代表所安装『知乎日报』的版本

• 响应实例：

  • 软件为最新版本时:

  { "status": 0, "latest": "2.2.0" } 

  • 软件为较老版本时:

  { "status": 1, "msg": "【更新内容】（后略）", "latest": "2.2.0" } 

• 分析:

3. 最新消息

• URL: http://news-at.zhihu.com/api/4/news/latest
• 响应实例:

{     date: "20140523",     stories: [     {     title: "中国古代家具发展到今天有两个高峰，一个两宋一个明末（多图）",     ga_prefix: "052321",     images: [     "http://p1.zhimg.com/45/b9/45b9f057fc1957ed2c946814342c0f02.jpg"      ],     type: 0,     id: 3930445     },     ...     ],     top_stories: [     {     title: "商场和很多人家里，竹制家具越来越多（多图）",     image: "http://p2.zhimg.com/9a/15/9a1570bb9e5fa53ae9fb9269a56ee019.jpg",     ga_prefix: "052315",     type: 0,     id: 3930883     },     ...     ]     } 

• 分析

4. 消息内容获取与离线下载

• URL: http://news-at.zhihu.com/api/4/news/{id}
• 响应实例:

{  body: "<div class=/"main-wrap content-wrap/">/n<div class=/"headline/">/n/n<div class=/"img-place-holder/"></div>/n/n/n/n</div>/n/n<div class=/"content-inner/">/n/n/n/n/n<div class=/"question/"> ... </div>",  image_source: "Yestone.com 版权图片库",  title: "瞎扯 · 如何正确地吐槽",  image: "http://pic2.zhimg.com/9fe062c07b11959a2dd47068e116a9d5.jpg",  share_url: "http://daily.zhihu.com/story/4760976",  js: [],  recommenders: [   {    avatar: "http://pic3.zhimg.com/449b2931521389e4fcbc31a0e2d9d896_m.jpg"   },   {    avatar: "http://pic1.zhimg.com/4e45f545ee8b194476d3131ca7f3a9c8_m.jpg"   },   {    avatar: "http://pic4.zhimg.com/6a682ab23_m.jpg"   }  ],  ga_prefix: "052606",  section: {   thumbnail: "http://pic3.zhimg.com/a82322fc78dff305c3df43fcc4cb96c2.jpg",   id: 2,   name: "瞎扯"  },  type: 0,  id: 4760976,  css: [   "http://news.at.zhihu.com/css/news_qa.auto.css?v=1edab"  ] }  

*分析:

可知，知乎日报的文章浏览界面利用 WebView(UIWebView) 实现

• 特别注意

  在较为特殊的情况下，知乎日报可能将某个主题日报的站外文章推送至知乎日报首页。

  • 响应实例:

  { "theme_name": "电影日报", "title": "五分钟读懂明星的花样昵称：一美、法鲨……", "share_url": "http://daily.zhihu.com/story/3942319", "js": [], "ga_prefix": "052921", "editor_name": "邹波", "theme_id": 3, "type": 1, "id": 3942319, "css": [ "http://news.at.zhihu.com/css/news_qa.6.css?v=b390f" ] } 

  此时返回的 JSON 数据缺少 body ， iamge-source ， image ， js 属性。多出 theme_name ， editor_name ， theme_id 三个属性。 type 由 0 变为 1。

5. 过往消息

• URL: http://news.at.zhihu.com/api/4/news/before/{date}
• 若果需要查询 11 月 18 日的消息，{date}的数字应为 20131119
• 知乎日报的生日为 2013 年 5 月 19 日，若 {date}数字小于 20130520 ，只会接收到空消息
• 响应实例：

{  date: "20131118",  stories: [   {    title: "深夜食堂 · 我的张曼妮",    ga_prefix: "111822",    images: [     "http://p4.zhimg.com/7b/c8/7bc8ef5947b069513c51e4b9521b5c82.jpg"    ],    type: 0,    id: 1747159   },  ...  ] }  

格式与前同，恕不再赘述

6. 新闻额外信息

• URL: http://news-at.zhihu.com/api/4/story-extra/#{id}
• 输入新闻的ID，获取对应新闻的额外信息，如评论数量，所获的『赞』的数量。
• 响应实例：

{ "long_comments": 0, "popularity": 161, "short_comments": 19, "comments": 19, } 

• 分析:

7. 新闻对应长评论查看

• URL: http://news-at.zhihu.com/api/4/story/#{id}/long-comments
• 使用在 最新消息 中获得的 id ，传入#{id}，得到长评论 JSON 格式的内容
• 响应实例:

{  "comments": [   {    "author": "EleganceWorld",    "id": 545442,    "content": "上海到济南，无尽的猪排盖饭… （后略）",    "likes": 0,    "time": 1413589303,    "avatar": "http://pic2.zhimg.com/1f76e6a25_im.jpg"   },   ...  ] }  

*分析:

8. 新闻对应短评论查看

• URL: http://news-at.zhihu.com/api/4/story/#{id}/short-comments
• 使用在 最新消息 中获得的 id ，传入#{id}，得到短评论 JSON 格式的内容
• 响应实例:

{  "comments": [   {    "author": "Xiaole说",    "id": 545721,    "content": "就吃了个花生米，呵呵",    "likes": 0,    "time": 1413600071,    "avatar": "http://pic1.zhimg.com/c41f035ab_im.jpg"   },   ...  ] }  

格式与前同，恕不再赘述

9. 主题日报列表查看

• URL: http://news-at.zhihu.com/api/4/themes
• 响应实例：

{  "limit": 1000,  "subscribed": [],  "others": [   {    "color": 15007,    "thumbnail": "http://pic3.zhimg.com/0e71e90fd6be47630399d63c58beebfc.jpg",    "description": "了解自己和别人，了解彼此的欲望和局限。",    "id": 13,    "name": "日常心理学"   }   ...  ] }  

• 分析:

10. 主题日报内容查看

• URL: http://news-at.zhihu.com/api/4/theme/#{id}
• 使用在 主题日报列表查看 中获得需要查看的主题日报的 id，赋值给#{id}，得到对应主题日报 JSON 格式的内容
• 响应实例：

{  "stories": [   {    "images": [     "http://pic4.zhimg.com/fabeb6ece13d1b4f3fecd484f475feeb_t.jpg"    ],    "type": 2,    "id": 4759968,    "title": "你的密码保护问题真的安全吗？"   },   {    "images": [     "http://pic2.zhimg.com/969a13db3fad18b1d35ce9d3e2633ef1_t.jpg"    ],    "type": 2,    "id": 4745004,    "title": "当DNS泄漏让VPN不再安全，我们该怎么办？"   },   ...  ],  "description": "把黑客知识科普到你的面前",  "background": "http://p4.zhimg.com/32/55/32557676e84fcfda4d82d9b8042464e1.jpg",  "color": 9699556,  "name": "互联网安全",  "image": "http://p4.zhimg.com/30/6f/306f3ab291c415f40fe4485b75627230.jpg",  "editors": [   {    "url": "http://www.zhihu.com/people/THANKS",    "bio": "FreeBuf.com 小编，专注黑客与极客",    "id": 65,    "avatar": "http://pic4.zhimg.com/ecd93e213_m.jpg",    "name": "THANKS"   },   {    "url": "http://www.zhihu.com/people/____",    "bio": "PKAV & Wooyun",    "id": 38,    "avatar": "http://pic1.zhimg.com/815b2ec82_m.jpg",    "name": "长短短"   },   ...  ],  "image_source": "" }  

• 分析: