开放 API

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

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

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

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

仅支持 json 格式的请求，范例：

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

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

仅支持 json 格式的请求，范例：

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

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

高级用户每天可调用 500 次 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（或其它自定义的收藏夹名称均可）

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

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