云收件箱

云收件箱让你可以通过一个简单的 HTTP API，从任意位置将任务投递到某个数据库的 收件箱（Inbox）。它适用于需要把任务推送到 HamsterBase Tasks 的脚本、自动化和各类集成场景，无需打开应用。

使用前请阅读

• 云收件箱是付费功能。 它包含在专业版和终身版中，详情请见价格部分。
• 收件箱的内容在服务器上是未加密的。 与端到端加密的其他数据不同，你通过云收件箱发送的标题和备注会以明文形式保存在服务器上，直到它们被同步进你的数据库。请勿通过云收件箱发送敏感或隐私信息。

创建 Token

一个 Token 用于授权向某一个特定数据库的收件箱投递任务。每个 Token 只绑定一个数据库。

1. 进入 设置 页面。
2. 打开 Sync（同步） 标签页。
3. 在 Database（数据库） 中，找到你想要投递任务的数据库。任务会被投递到这个数据库的 收件箱（Inbox）。
4. 点击对应按钮为该数据库开启云收件箱，系统会创建一个 Token。
5. 点击 复制，将 Token 复制到剪贴板。

Token 的格式类似下面这样：

tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

WARNING

请妥善保管该 Token。任何拿到它的人都可以向你数据库的收件箱投递任务。

投递任务

向投递接口发送一个 POST 请求，并在 Authorization 请求头中携带 Token。

• 接口地址： https://cloud.hamsterbase.com/api/tasks/inbox/v1/append
• 请求方法： POST
• 请求头： Content-Type: application/json、Authorization: Bearer <token>
• 请求体： { "title": "<标题>", "notes": "<备注>", "due_date": <截止日期> }

字段	类型	必填	说明
title	string	是	任务标题。
notes	string | null	否	任务备注。
due_date	number | null	否	截止日期，毫秒级 Unix 时间戳，取目标日期的 UTC 零点。不传或传 null 表示没有截止日期。

如何计算 due_date

截止日期是以 UTC 零点为锚点的整天日期。使用 Date.UTC(year, month - 1, day)（注意月份从 0 开始）。例如 2026-05-20 对应 Date.UTC(2026, 4, 20) = 1779235200000。

示例：curl

curl -X POST https://cloud.hamsterbase.com/api/tasks/inbox/v1/append \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"title":"买牛奶","notes":"回家路上顺便买","due_date":1779235200000}'

请求成功时接口返回 HTTP 200。任务会在同步后出现在所选数据库的收件箱中。