码迷，mamicode.com
首页 > Windows程序 > 详细

知乎日报 API 分析

时间：2017-08-07 10:01:36      阅读：327      评论：0      收藏：0      [点我收藏+]

标签：idt   neu   like   stat   init   nts   查看   长度   能力   

声明

下面全部 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的主页

知乎日报 API 分析

标签：idt   neu   like   stat   init   nts   查看   长度   能力   

原文地址：http://www.cnblogs.com/wzjhoutai/p/7297445.html
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！