gopeed: 协议唤起:一条链接直接创建任务或装扩展
它在系统里注册了 gopeed: 自定义协议——任何能打开链接的地方(浏览器地址栏、其他应用、命令行)都能用它直接唤起主程序执行操作。
URI 格式
gopeed:///create?params=<base64 编码的 JSON>
gopeed:///extension?params=<base64 编码的 JSON>
params 是 Base64 编码的 JSON 参数。
创建下载任务
参数结构与创建任务 API 的请求体一致,最简形式:
{
"req": {
"url": "magnet:?xt=urn:btih:你的资源指纹"
}
}
把这段 JSON 做 Base64 编码,拼进 URI 即可:
gopeed:///create?params=eyJyZXEiOnsidXJsIjoibWFnbmV0P...(编码后的字符串)
浏览器地址栏回车,系统弹窗确认后任务直接出现在主程序里。ed2k 链接、HTTP 直链同理。
安装扩展
{
"url": "扩展的 Git 仓库地址",
"devMode": false
}
同样 Base64 编码后拼进 gopeed:///extension 格式。扩展仓库地址的选择见扩展怎么装。
典型用途
- 给网页做「一键下载」按钮:站长把预编码的 URI 放进页面链接;
- 脚本/快捷指令唤起:iOS 快捷指令、Windows 快捷方式都可以拼 URI 直达任务;
- 与安卓接管互补:安卓上还有系统级下载接管,见安卓下载接管。
相关阅读
- API 侧的等价操作:开启 HTTP API。