知乎日报 API 分析

声明

下面全部 API 均由 知乎（Zhihu.Inc） 提供，本人採取非正常手段获取。

获取与共享之行为或有侵犯知乎权益的嫌疑。若被告知需停止共享与使用。本人会及时删除此页面与整个项目。

请您暸解相关情况。并遵守知乎协议。

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/1080*1776

• start-image 后为图像分辨率，接受例如以下格式

  • 320*432
  • 480*728
  • 720*1184
  • 1080*1776

• 响应实例：

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

• 分析：

  • text : 供显示的图片版权信息
  • img : 图像的 URL

2.
软件版本号查询

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

• 响应实例：

  软件为最新版本号时

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

  软件为较老版本号时

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

• 分析：

  • status : 0 代表软件为最新版本号，1 代表软件须要升级
  • latest : 软件最新版本号的版本号号（数字的第二段会比最新的版本号号低 1）
  • msg : 仅出如今软件须要升级的情形下。提示用户升级软件的对话框中显示的消息

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
          },
      ...
      ]
  }
  

• 分析：

  • date : 日期
  • stories : 当日新闻
    • title : 新闻标题
    • images : 图像地址（官方 API 使用数组形式。

      眼下暂未有使用多张图片的情形出现，曾见无 images 属性的情况，请在使用中注意
      ）

    • ga_prefix : 供 Google Analytics 使用
    • type : 作用未知
    • id : url 与 share_url 中最后的数字（应为内容的
      id）
    • multipic : 消息是否包括多张图片（仅出如今包括多图的新闻中）
  • top_stories : 界面顶部 ViewPager 滚动显示的显示内容（子项格式同上）

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

• URL: http://news-at.zhihu.com/api/4/news/3892357
• 使用在 最新消息 中获得的 id，拼接在 http://news-at.zhihu.com/api/4/news/ 后，得到相应消息
  JSON 格式的内容

• 响应实例：

  {
      body: "<div class="main-wrap content-wrap">...</div>",
      image_source: "Yestone.com 版权图片库",
      title: "深夜惊奇 · 朋友圈错觉",
      image: "http://pic3.zhimg.com/2d41a1d1ebf37fb699795e78db76b5c2.jpg",
      share_url: "http://daily.zhihu.com/story/4772126",
      js: [ ],
      recommenders": [
          { "avatar": "http://pic2.zhimg.com/fcb7039c1_m.jpg" },
          { "avatar": "http://pic1.zhimg.com/29191527c_m.jpg" },
          { "avatar": "http://pic4.zhimg.com/e6637a38d22475432c76e6c9e46336fb_m.jpg" },
          { "avatar": "http://pic1.zhimg.com/bd751e76463e94aa10c7ed2529738314_m.jpg" },
          { "avatar": "http://pic1.zhimg.com/4766e0648_m.jpg" }
      ],
      ga_prefix: "050615",
      section": {
          "thumbnail": "http://pic4.zhimg.com/6a1ddebda9e8899811c4c169b92c35b3.jpg",
          "id": 1,
          "name": "深夜惊奇"
      },
      type: 0,
      id: 4772126,
      css: [
          "http://news.at.zhihu.com/css/news_qa.auto.css?v=1edab"
      ]
  }
  

• 分析：

  • body : HTML 格式的新闻
  • image-source : 图片的内容提供方。为了避免被起诉非法使用图片，在显示图片时最好附上其版权信息。
  • title : 新闻标题
  • image : 获得的图片同 最新消息 获得的图片分辨率不同。这里获得的是在文章浏览界面中使用的大图。
  • share_url : 供在线查看内容与分享至 SNS 用的 URL
  • js : 供手机端的 WebView(UIWebView) 使用
  • recommenders : 这篇文章的推荐者
  • ga_prefix : 供 Google Analytics 使用
  • section : 栏目的信息
    • thumbnail : 栏目的缩略图
    • id : 该栏目的 id
    • name : 该栏目的名称
  • type : 新闻的类型
  • id : 新闻的 id
  • css : 供手机端的 WebView(UIWebView) 使用
    • 可知，知乎日报的文章浏览界面利用 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。image-source，image，js 属性。

  多出theme_name。editor_name，theme_id 三个属性。type 由 0 变为 1。

5.
过往消息

• URL: http://news.at.zhihu.com/api/4/news/before/20131119
• 若果须要查询 11 月 18 日的消息，before 后的数字应为 20131119
• 知乎日报的生日为 2013 年 5 月 19 日，若 before 后数字小于 20130520 ，仅仅会接收到空消息
• 输入的今日之后的日期仍然获得今日内容，可是格式不同于最新消息的 JSON 格式

• 响应实例：

  {
      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,
  }
  

• 分析：

  • long_comments : 长评论总数
  • popularity : 点赞总数
  • short_comments : 短评论总数
  • comments : 评论总数

7.
新闻相应长评论查看

• URL: http://news-at.zhihu.com/api/4/story/4232852/long-comments
• 使用在 最新消息 中获得的 id，在 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"
          },
          ...
      ]
  }
  

• 分析：

  • comments : 长评论列表，形式为数组（请注意，其长度可能为 0）
    • author : 评论作者
    • id : 评论者的唯一标识符
    • content : 评论的内容
    • likes : 评论所获『赞』的数量
    • time : 评论时间
    • avatar : 用户头像图片的地址

8.
新闻相应短评论查看

• URL: http://news-at.zhihu.com/api/4/story/4232852/short-comments
• 使用在 最新消息 中获得的 id。在 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": 8307764,
              "thumbnail": "http://pic4.zhimg.com/2c38a96e84b5cc8331a901920a87ea71.jpg",
              "description": "内容由知乎用户推荐，海纳主题百万，趣味上天入地",
              "id": 12,
              "name": "用户推荐日报"
          },
          ...
      ]
  }
  

  • 分析：
    • limit : 返回数目之限制（仅为推測）
    • subscribed : 已订阅条目
    • others : 其它条目
      • color : 颜色，作用未知
      • thumbnail : 供显示的图片地址
      • description : 主题日报的介绍
      • id : 该主题日报的编号
      • name : 供显示的主题日报名称

10.
主题日报内容查看

• URL: http://news-at.zhihu.com/api/4/theme/11
• 使用在 主题日报列表查看 中获得须要查看的主题日报的 id。拼接在 http://news-at.zhihu.com/api/4/theme/ 后，得到相应主题日报
  JSON 格式的内容

• 响应实例：

  {
      stories: [
          {
              images: [
                  "http://pic1.zhimg.com/84dadf360399e0de406c133153fc4ab8_t.jpg"
              ],
              type: 0,
              id: 4239728,
              title: "前苏联监狱纹身百科图鉴"
          },
          ...
      ],
      description: "为你发现最有趣的新奇事，建议在 WiFi 下查看",
      background: "http://pic1.zhimg.com/a5128188ed788005ad50840a42079c41.jpg",
      color: 8307764,
      name: "不许无聊",
      image: "http://pic3.zhimg.com/da1fcaf6a02d1223d130d5b106e828b9.jpg",
      editors: [
          {
              url: "http://www.zhihu.com/people/wezeit",
              bio: "微在 Wezeit 主编",
              id: 70,
              avatar: "http://pic4.zhimg.com/068311926_m.jpg",
              name: "益康糯米"
          },
          ...
      ],
      image_source: ""
  }
  

  • 分析：
    • stories : 该主题日报中的文章列表
      • images : 图像地址（其类型为数组。请留意在代码中处理无该属性与数组长度为 0 的情况）
      • type : 类型，作用未知
      • title : 消息的标题
    • description : 该主题日报的介绍
    • background : 该主题日报的背景图片（大图）
    • color : 颜色，作用未知
    • name : 该主题日报的名称
    • image : 背景图片的小图版本号
    • editors : 该主题日报的编辑（『用户推荐日报』中此项的指是一个空数组。在 App 中的主编栏显示为『很多人』，点击后訪问该主题日报的介绍页面，请留意）
      • url : 主编的知乎用户主页
      • bio : 主编的个人简单介绍
      • id : 数据库中的唯一表示符
      • avatar : 主编的头像
      • name : 主编的姓名
    • image_source : 图像的版权信息

11.
热门消息

• 请注意！ 此 API 仍可訪问，可是其内容未出如今最新的『知乎日报』 App 中。
• URL: http://news-at.zhihu.com/api/3/news/hot

• 响应实例：

  {
      recent: [
          {
              news_id: 3748552,
              url: "http://daily.zhihu.com/api/2/news/3748552",
              thumbnail: "http://p3.zhimg.com/67/6a/676a8337efec71a100eea6130482091b.jpg",
              title: "长得美丽能力出众性格单纯的姑娘为什么会没有男朋友？"
          },
      ...
      ]
  }
  

• 大体同前面介绍的 API 类似，唯一须要注意的是：欲获得图片地址。不再使用 image 而是thumbnail 属性

• url 属性可直接使用。请注意，url 中的 api 属性为 2，是较老版本号。

12.
软件推广

• 请注意。 此 API 已无法訪问，可是其内容曾出现于『知乎日报』 App 中。
• Android: http://news-at.zhihu.com/api/3/promotion/android
• iOS: http://news-at.zhihu.com/api/3/promotion/ios

13.
栏目总览

• 请注意！

  此 API 仍可訪问。可是其内容未出如今最新的『知乎日报』 App 中。

• URL: http://news-at.zhihu.com/api/3/sections

• 响应实例：

  {
      data: [
          {
              id: 1,
              thumbnail: "http://p2.zhimg.com/10/b8/10b8193dd6a3404d31b2c50e1e232c87.jpg",
              name: "深夜食堂",
              description: "睡前宵夜，用别人的故事下酒"
          },
      ...
      ]
  }
  

• 相同，注意使用 thumbnail 获取图像的地址

14.
栏目详细消息查看

• 请注意！ 此 API 仍可訪问，可是其内容未出如今最新的『知乎日报』 App 中。
• URL: http://news-at.zhihu.com/api/3/section/1
• URL 最后的数字见『栏目总览』中对应栏目的 id 属性

• 响应实例：

  {
      news: [
          {
              date: "20140522",
              display_date: "5 月 22 日"
          },
      ...
      ],
      name: "深夜食堂",
      timestamp: 1398780001
  }
  

• 往前：http://news-at.zhihu.com/api/3/section/1/before/1398780001

  • 在 URL 最后加上一个时间戳，时间戳详见 JSON 数据末端的 timestamp 属性

15.
查看新闻的推荐者

• URL: http://news-at.zhihu.com/api/4/story/#{id}/recommenders
• 将新闻id填入到#{id}的位置。 如 http://news-at.zhihu.com/api/4/story/7101963/recommenders

• 响应实例

  {
      "items": [],
      "editors": [{
          "bio": "树上的女爵",
          "title": "主编",
          "id": 79,
          "avatar": "http:\/\/pic1.zhimg.com\/0a6456810_m.jpg",
          "name": "刘柯"
      }],
      "item_count": 1
  }
  

16.
获取某个专栏之前的新闻

• URL: http://news-at.zhihu.com/api/4/theme/#{theme id}/before/#{id}
• 将专栏id填入到 #{theme id}, 将新闻id填入到#{id}，如 http://news-at.zhihu.com/api/4/theme/11/before/7119483
• 注：新闻id要是属于该专栏，否则。返回结果为空

• 响应实例：

  {
      "stories": [
          {
              "images": [
                  "http://pic2.zhimg.com/27f3d8f4c1e0000d04ee446a2f020cf1_t.jpg"
               ],
              "type": 2,
              "id": 7119477,
              "title": "9 张本周最热节操图。诺一就是人生赢家本人"
          }, ...
      ]
  }
  

17.
查看editor的主页

• iOS: http://news-at.zhihu.com/api/4/editor/#{id}/profile-page/ios
• Android: http://news-at.zhihu.com/api/4/editor/#{id}/profile-page/android
• 如 http://news-at.zhihu.com/api/4/editor/79/profile-page/ios