# 开放 API

Cubox 目前开放了用来收藏常见内容的 API 接口。支持收藏网页和速记。

开放 API 为高级会员独享功能,你可以配合其它工具,或开发自己的收集小应用,来满足日常工作流程的个性化需求。

在 Cubox 网页版设置 > 扩展与下载 中,找到 开放 API 设置项。点击 启用 API 以获得你自己的 API 链接。

⚠️ API 链接是你个人身份的唯一凭证,请勿泄露以防它人滥用。你可以点击刷新按钮重新生成一个新的 API 链接,此时旧的链接会失效。

collect_API_1

仅支持 json 格式的请求,范例:


{
"type":"url",
"content":"https://apple.com",
"title":"标题",
"description":"描述",
"tags":["标签A","标签B","标签C"],
"folder":"收藏夹名称"
}

收藏成功后,Cubox 云端会自动开始进行文章解析、快照存档等一处理,可能需要些时间。

collect_API_2

仅支持 json 格式的请求,范例:


{
"type":"memo",
"content":"速记的文本内容",
"title":"标题",
"description":"描述",
"tags":["标签A","标签B","标签C"],
"folder":"收藏夹名称"
}

如果不指定标题或描述,Cubox 会尝试帮你生成。如果不指定收藏夹,内容会默认收藏到你的收件箱。

⚠️ 高级用户每天可调用 200 次 API

# 用例参考

# 转发邮件自动收藏

借助 Cubox 收藏 API 和 IFTTT 的邮件触发条件,可以实现发送邮件来保存链接和速记的功能,配置后只需将内容通过 IFTTT 注册邮箱,发送给 trigger@applet.ifttt.com 即可完成收藏。点击阅读相关文章 (opens new window)

# 1. 转发邮件到 Cubox 速记

注册/登陆 IFTTT,点击顶部 Create,If This > 搜索添加 Email > Send IFTTT any email,Then That > 搜索添加 Webhooks > make a web request,按照以下设置:

  • URL → 填入 Cubox API 链接(可在 Cubox 网页版设置中复制)
  • Method → POST
  • Content Type → application/json
  • Additional Headers 留空无需填写
  • Body 一栏中粘贴以下代码:
{
"type":"memo",
"content":"<<<{{Body}}>>>",
"folder":"邮件备份",
"tags":["邮件"]
}

其中的「邮件备份」和「邮件」可自行修改为合适的收藏夹名称和标签。

填写信息后 > Create action > Continue > Finish 即可完成配置。

# 2. 邮件发送一段链接收藏网页

在一些不方便使用 Cubox 收藏插件的场景或特殊平台,可以通过发送邮件来收藏链接。具体配置步骤与邮件收藏速记基本一致,只需在最后的 Body 一栏中输入不同代码即可:

注册/登陆 IFTTT,点击顶部 Create,If This > 搜索添加 Email > Send IFTTT any email,Then That > 搜索添加 Webhooks > make a web request,按照以下设置:

  • URL → 填入 Cubox API 链接(可在 Cubox 网页版设置中复制)
  • Method → POST
  • Content Type → application/json
  • Additional Headers 留空无需填写
  • Body 一栏中粘贴以下代码:

{
"type": "url",
"content": "<<<{{Body}}>>>" }

填写信息后 > Create action > Continue > Finish 即可完成配置,收藏的链接将保存到「收集箱」。收藏速记配置 & 收藏链接配置:

collect_API_3

ℹ️ 由于邮件内容无法被自动区分为链接或速记,如同时配置以上两个邮件触发条件,会导致邮件重复识别。可以使用 IFTTT 的邮件 Tag 功能解决,比如在配置时分别添加 #link 和 #memo 来区分链接和速记,这样在发送邮件收藏时,将 Tag 内容作为邮件主题即可调用相应的自动化。

# RSS 自动汇入 Cubox

利用一些自动化的第三方服务,如 Integrately, IFTTT, Zapier... 你可以将订阅的 RSS 源中最优质的内容设置自动发送到 Cubox,免去手动发送这一步骤。下面以 Integrately 为例介绍两种配置方法,点击阅读相关文章 (opens new window)

# 1. Inoreader 星标文章自动汇入 Cubox

  • 在 Integrately 配置添加步骤中分别选择 Inoreader 和 Webhook / API Integration,下拉至底部,在 When 和 Do 中分别选择:New article is starred in Inoreader 和 POST in Webhook / API Integration;Go>
  • 关联 Inoreader 账户,根据提示操作即可;继续编辑,在步骤 2 Set Fields of POST > URL 一栏中粘贴已准备的 Cubox API 链接;在下方的 Body / Data 一栏中,按照以下设置:

type → url
content → 选择右侧弹出含链接的 Canonical Url
title → 选择右侧弹出的 Article Title
description → 没有可选可以留空
folder → RSS Starred(或其它自定义的收藏夹名称均可)

collect_API_4_2

最后 Test & Activate,测试保存后即可在 Cubox 对应收藏夹中看到测试内容。

ℹ️ Integrately 似乎暂不支持 array 格式的值,因此目前无法添加 Tag

# 2. RSS 订阅源自动汇入 Cubox

  • 在 Integrately 配置添加步骤中分别选择 RSS 和 Webhook / API Integration;下拉至底部,在 When 和 Do 中分别选择:New item is created in RSS 和 POST in Webhook / API Integration;Go>
  • 填写 RSS 订阅源链接;继续编辑,在步骤2 Set Fields of POST > URL 一栏中粘贴已准备的 Cubox API 链接;在下方的 Body / Data 一栏中,按照以下设置:

type → url
content → 选择右侧弹出含链接的 Id 或 Alternate Link
title → 选择右侧弹出的 Title
description → 选择 Summary 或 Description Text(如果订阅源的描述为图文等复杂内容,也可以留空 Cubox 收藏时会再次抓取)
folder → RSS News(或其它自定义的收藏夹名称均可)

collect_API_5

最后 Test & Activate,测试保存后即可在 Cubox 对应收藏夹中看到测试内容。