# 开放 API

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

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

在 Cubox 网页版设置 (opens new window) > 扩展中心和自动化 > 开放 API 中,启用 API 以获得你自己的 API 链接。

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

collect_API

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


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

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

collect_API

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


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

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

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

# 用例参考

# 通过邮件收藏链接

借助 Cubox 收藏 API 和 IFTTT 的邮件触发条件,可以实现发送邮件来保存链接的功能,配置后只需将内容通过 IFTTT 注册邮箱,发送给 trigger@applet.ifttt.com 即可完成收藏。

具体配置步骤:注册/登陆 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 即可完成配置,收藏的链接将保存到「收集箱」。

# RSS 订阅自动汇入 Cubox

利用一些自动化的第三方服务,如 Integrately, IFTTT, Zapier... 你可以将订阅的优质 RSS 内容设置自动发送到 Cubox,免去手动发送这一步骤。下面以 Integrately 为例介绍下配置方法,具体操作可能会由于第三方工具的改版而略有不同。

💡 建议将其作为一种辅助的内容收藏方式,让 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 对应收藏夹中看到测试内容。

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