跳转至

理解路由

通常来说,每个 RSS 消息来源都有一个订阅链接。以卫报世界新闻为例,它的订阅链接是 www.theguardian.com/world/rss。在这个订阅链接中,第一个斜线 / 前的部分被称作域名(domain),即 www.theguardian.com;其后的部分被称作路由(route),即 /world/rss。你可以将一个订阅链接想象成一条路线,其中域名是大致的地址,而路由则具体到具体某楼某单元某层某室:有了订阅链接,你就可以循着它在互联网上找到你所需要的资源。

Note

这里对订阅链接的定义并不完全符合 URL 标准。文档对此作了一定的简化,方便无技术背景的读者理解。

实例与路由

如果你希望通过 RSSerpent 来订阅一些不支持 RSS 的网站,那么同理 —— 你也需要找到对应资源的订阅链接。对于 RSSerpent 来说,订阅链接同样分成域名与路由两部分:

  • 每个域名都对应着一个 RSSerpent 实例,例如官方域名 www.rsserpent.com 就对应着官方实例。你可以在[部署]页面上找到一些官方实例,但我们更推荐你自建实例以满足你个人变化而多样的需求。
  • 默认情况下,RSSerpent 实例不装载任何路由。实例的维护者需要通过[安装插件]来为实例装载路由。如果你在使用某个他人的实例时发现缺少了你需要的插件或路由,你可以向实例维护者提出申请,或者选择自建实例。

Note

实例是指一份正在运行中的 RSSerpent 软件体。

Note

每个 RSSerpent 插件都包含一个或多个路由。

RSSerpent 的官方实例上装载了哔哩哔哩插件。因此,你可以在官方实例上使用路由 /bilibili/user/{id}/video 来订阅某个用户发布的视频。例如,如果你希望订阅 Chubbyemu 在哔哩哔哩的官方中文翻译频道,那么通过拼接官方实例的域名 www.rsserpent.com 与路由 /bilibili/user/297786973/video 你可以得到如下订阅链接:

RSSerpent Bilibili Chubbyemu

路由参数

Warning

本章文档剩余内容中的任何示例仅供参考,不保证在任何实例上真实可用。

在上面的例子中,我们注意到,部分路由并不是完整的,需要你填写某些信息才能正常工作。举例来说,假设这个路由能够帮助你订阅某个用户发布的视频,但它却无法知道用你希望订阅的具体是哪个用户 —— 这时就需要你来填写部分路由参数。有了这些参数作为输入,路由才能完整正常地工作。

路由参数一般被花括号 {} 包裹,在实际填写时,你应该去掉这对花括号。不同的路由是由不同的插件来提供的,一般来说,你可以在相关插件的文档页面找到各个路由参数的含义、以及你应该如何去获取并填写这些参数。

以路由 /bilibili/user/{id}/video 为例,该路由接受一个路由参数 id。每个哔哩哔哩用户都具有一个唯一标识码(即 ID),你通常可以在用户主页的地址中找到这个唯一标识码。通过这个唯一标识码,路由才能找到该用户发布的视频,并将视频列表输出为订阅链接供你订阅。

查询参数

路由参数是必填的。但有时候,有些路由还需要接受一些选填的、可变的、有条件的参数 —— 这些参数被称为查询参数

  • 查询参数应置于路由尾部,以 ? 问号与路由主体隔开;
  • 查询参数可以有任意多个,每个形如 {name}={value}
  • 查询参数之间以 & 隔开。

举例来说,假设路由 /bilibili/user/{id}/video 接受 sortorder 两个查询参数:其中 sort 用于指定视频的排序标准,order 则用于指定视频的排序升/降序。考虑到绝大多数用户希望订阅某用户发布的最新视频,因此在默认情况下(即不传入任何查询参数),路由会按照时间降序对视频进行排序。但假设你需要订阅某用户最热门的视频,则路由应为 /bilibili/user/{id}/video?sort=hot&order=desc


最后更新: 2022-03-18
回到页面顶部