接入指南
内容订阅
使用 Atom 阅读器关注教程与资源的公开更新。
订阅教程
在教程列表点击“订阅更新”,将链接添加到支持 Atom 的阅读器:
/tutorials.atom
/tutorials.atom?tag=utility&mc=1.20.1
列表订阅沿用现有公开教程列表,按整篇更新时间倒序返回。入口会保留当前标签和游戏版本筛选,不复制页码。默认最近 20 篇,可通过 limit=50 增加条数,最大 50;tag、mc 支持重复参数或英文逗号分隔,匹配语义沿用教程列表。
在单篇教程点击“订阅更新”,可以只关注该教程:
/tutorials/example-guide/updates.atom
单篇订阅使用教程的稳定 ID,同一教程修改后更新原条目的更新时间、标题和摘要,并提供阅读链接。它提示整篇教程有更新,不提供逐章节更新记录、完整正文或修改对比。章节变更的后端设计不属于本次订阅范围。
两种订阅都匿名读取,只输出当前公开的教程。每次读取复核当前状态后再处理 ETag/304;教程变为不可公开读取时,单篇订阅返回 404。网络故障不表示教程删除,阅读器应保留最后成功结果并退避重试。订阅是有界当前快照,不保证历史追赶或清除阅读器已保存的旧内容。
这些地址使用主站域名,站点应沿用全站 Feed 配置的 NUXT_SITE_URL,以生成正确的绝对链接;缺少该配置时教程 Atom 返回 503。它们属于 Web 站点输出,不增加公共 API 网关操作或机器 scope。
其它订阅
- 全站资源、教程与帖子混合订阅:
/atom.xml;另有/rss.xml和/feed.json。 - 单个资源版本更新:
/resources/:slug/releases.atom,用法见资源更新与 Webhook。