知乎日报API

张晨朗

2023-12-01

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 属性

知乎日报API

API说明

API 分析

1. 启动界面图像获取

2. 软件版本查询

3. 最新消息

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

5. 过往消息

6. 新闻额外信息

7. 新闻对应长评论查看

8. 新闻对应短评论查看

9. 主题日报列表查看

10. 主题日报内容查看

11. 热门消息

12. 软件推广

13. 栏目总览

14. 栏目具体消息查看

相关阅读

相关文章

相关问答

相关文档