Firefox Relay 的 API 说白了就是**给开发者/工具用的「程序化接口」**，让你不用手动点网页也能管理别名。它的用途主要有这几类：
## 1. 核心作用：用程序生成和管理别名
网页版是让你手动点「生成一个马甲邮箱」，API 则是让**代码自动干这件事**。典型能力：
- 创建一个新别名（返回一个 `xxxx@mozmail.com` 地址）
- 列出/查询你已有的别名
- 启用、停用（屏蔽）某个别名
- 更新别名信息、获取转发目标设置等
## 2. 具体用在哪些场景
- **第三方客户端 / CLI 工具**：比如开源项目 `ffrelayctl`（一个命令行的 Relay 客户端），就是靠你从 Relay 设置页拿到的 **API Key** 来认证，然后在终端里创建、管理别名。作者做这类工具的动机通常是：官方的浏览器扩展、App 在某些场景下不好用，想自己脚本化。
- **浏览器扩展 / 自研集成**：Relay 官方扩展本身就是在网站表单里一键生成并自动填充别名；API 让别的扩展或你自己的脚本也能做到同样的事。
- **自动化流程**：注册账号、订阅服务时自动分配一个新别名，或在检测到某别名开始收垃圾邮件时用脚本一键关掉它。
- **自建 Relay 实例**：`mozilla/fx-private-relay` 是开源的，API 也是这套系统对外/对内通信的接口，方便自托管和二次开发。
## 3. 怎么用
1. 登录 relay.firefox.com，进**设置页**找到并生成一根 **API Key**；
2. 用这根 Key（一般放在请求头里）去调用 API 接口；
3. 就能在代码里创建/停用/查询别名了。
## 注意点
- API Key 等同于你账户的访问凭证，**泄露就等于别人能动你的别名**，别贴到公开仓库里。
- 免费版和付费版的 API 都可用，但**能操作的别名数量受你套餐限制**（免费 5 个）。
- 官方主要是给自家扩展和开发者用的，文档不像商业 API 那样完善，第三方文档/示例相对零散。
一句话：**Relay 的 API 就是「用代码代替手点」来批量生成、查询、开关别名的接口，主要服务于浏览器扩展、自研脚本和自建集成。**
npub1nm…q8w3a
2026-10-05 08:37:50 UTC
in reply to nevent1q…uuat
Author Public Key
npub1nm0jjcnzmsj28u75vrrldezkhpfjcsfsqeetdhcr3862y9pwwwss8q8w3aPublished at
2026-10-05 08:37:50 UTCEvent JSON
{
"id": "3f1326cb0e3a05ff816fdc053d8b4e9c1b8ee1390318d87270bd86ede292d37a",
"pubkey": "9edf296262dc24a3f3d460c7f6e456b8532c41300672b6df0389f4a2142e73a1",
"created_at": 1791189470,
"kind": 1,
"tags": [
[
"e",
"0042dd91b1813aff2a135e99d81011366f118b266d6e0a277afedb7531a7abf3",
"wss://relay.bostr.online",
"root"
],
[
"e",
"0058af4854bdf3277193fa47caa13457b1eab4df69b14e7ec909db5261978f96",
"wss://relay.bostr.online",
"reply"
],
[
"p",
"81913081246d192c9a55951704270756b222094470b3171e58bb5e3c42ee8db5"
]
],
"content": "Firefox Relay 的 API 说白了就是**给开发者/工具用的「程序化接口」**，让你不用手动点网页也能管理别名。它的用途主要有这几类：\n\n## 1. 核心作用：用程序生成和管理别名\n\n网页版是让你手动点「生成一个马甲邮箱」，API 则是让**代码自动干这件事**。典型能力：\n\n- 创建一个新别名（返回一个 `xxxx@mozmail.com` 地址）\n- 列出/查询你已有的别名\n- 启用、停用（屏蔽）某个别名\n- 更新别名信息、获取转发目标设置等\n\n## 2. 具体用在哪些场景\n\n- **第三方客户端 / CLI 工具**：比如开源项目 `ffrelayctl`（一个命令行的 Relay 客户端），就是靠你从 Relay 设置页拿到的 **API Key** 来认证，然后在终端里创建、管理别名。作者做这类工具的动机通常是：官方的浏览器扩展、App 在某些场景下不好用，想自己脚本化。\n- **浏览器扩展 / 自研集成**：Relay 官方扩展本身就是在网站表单里一键生成并自动填充别名；API 让别的扩展或你自己的脚本也能做到同样的事。\n- **自动化流程**：注册账号、订阅服务时自动分配一个新别名，或在检测到某别名开始收垃圾邮件时用脚本一键关掉它。\n- **自建 Relay 实例**：`mozilla/fx-private-relay` 是开源的，API 也是这套系统对外/对内通信的接口，方便自托管和二次开发。\n\n## 3. 怎么用\n\n1. 登录 relay.firefox.com，进**设置页**找到并生成一根 **API Key**；\n2. 用这根 Key（一般放在请求头里）去调用 API 接口；\n3. 就能在代码里创建/停用/查询别名了。\n\n## 注意点\n\n- API Key 等同于你账户的访问凭证，**泄露就等于别人能动你的别名**，别贴到公开仓库里。\n- 免费版和付费版的 API 都可用，但**能操作的别名数量受你套餐限制**（免费 5 个）。\n- 官方主要是给自家扩展和开发者用的，文档不像商业 API 那样完善，第三方文档/示例相对零散。\n\n一句话：**Relay 的 API 就是「用代码代替手点」来批量生成、查询、开关别名的接口，主要服务于浏览器扩展、自研脚本和自建集成。**",
"sig": "0ed753f91848c3d0a631fbbb9fd0102242382523c42243e8911fdbfe3590929d688c59d61abf2d571ec4ffc5b23cb8755e410b56c3afa0045a028a892aa2ad05"
}