理解路由¶
通常来说，每个 RSS 消息来源都有一个订阅链接。以卫报世界新闻为例，它的订阅链接是 www.theguardian.com/world/rss。在这个订阅链接中，第一个斜线 / 前的部分被称作域名（domain），即 www.theguardian.com；其后的部分被称作路由（route），即 /world/rss。你可以将一个订阅链接想象成一条路线，其中域名是大致的地址，而路由则具体到具体某楼某单元某层某室：有了订阅链接，你就可以循着它在互联网上找到你所需要的资源。
Note
这里对订阅链接的定义并不完全符合 URL 标准。文档对此作了一定的简化，方便无技术背景的读者理解。
实例与路由¶
如果你希望通过 RSSerpent 来订阅一些不支持 RSS 的网站，那么同理 —— 你也需要找到对应资源的订阅链接。对于 RSSerpent 来说，订阅链接同样分成域名与路由两部分：
- 每个域名都对应着一个 RSSerpent 实例，例如官方域名 rsserpent.imciel.com 就对应着官方实例。你可以在[部署]页面上找到一些官方实例，但我们更推荐你自建实例以满足你个人变化而多样的需求。
- 默认情况下，RSSerpent 实例不装载任何路由。实例的维护者需要通过[安装插件]来为实例装载路由。如果你在使用某个他人的实例时发现缺少了你需要的插件或路由，你可以向实例维护者提出申请，或者选择自建实例。
Note
实例是指一份正在运行中的 RSSerpent 软件体。
Note
每个 RSSerpent 插件都包含一个或多个路由。
RSSerpent 的官方实例上装载了哔哩哔哩插件。因此，你可以在官方实例上使用路由 /bilibili/user/{id}/video 来订阅某个用户发布的视频。例如，如果你希望订阅 Chubbyemu 在哔哩哔哩的官方中文翻译频道，那么通过拼接官方实例的域名 rsserpent.imciel.com 与路由 /bilibili/user/297786973/video 你可以得到如下订阅链接：
路由参数¶
Warning
本章文档剩余内容中的任何示例仅供参考，不保证在任何实例上真实可用。
在上面的例子中，我们注意到，部分路由并不是完整的，需要你填写某些信息才能正常工作。举例来说，假设这个路由能够帮助你订阅某个用户发布的视频，但它却无法知道用你希望订阅的具体是哪个用户 —— 这时就需要你来填写部分路由参数。有了这些参数作为输入，路由才能完整正常地工作。
路由参数一般被花括号 {} 包裹，在实际填写时，你应该去掉这对花括号。不同的路由是由不同的插件来提供的，一般来说，你可以在相关插件的文档页面找到各个路由参数的含义、以及你应该如何去获取并填写这些参数。
以路由 /bilibili/user/{id}/video 为例，该路由接受一个路由参数 id。每个哔哩哔哩用户都具有一个唯一标识码（即 ID），你通常可以在用户主页的地址中找到这个唯一标识码。通过这个唯一标识码，路由才能找到该用户发布的视频，并将视频列表输出为订阅链接供你订阅。
查询参数¶
路由参数是必填的。但有时候，有些路由还需要接受一些选填的、可变的、有条件的参数 —— 这些参数被称为查询参数：
- 查询参数应置于路由尾部，以
?问号与路由主体隔开； - 查询参数可以有任意多个，每个形如
{name}={value}； - 查询参数之间以
&隔开。
举例来说，假设路由 /bilibili/user/{id}/video 接受 sort 与 order 两个查询参数：其中 sort 用于指定视频的排序标准，order 则用于指定视频的排序升/降序。考虑到绝大多数用户希望订阅某用户发布的最新视频，因此在默认情况下（即不传入任何查询参数），路由会按照时间降序对视频进行排序。但假设你需要订阅某用户最热门的视频，则路由应为 /bilibili/user/{id}/video?sort=hot&order=desc。