开发者

三套接口：AI 大模型版本查询免密钥直接 GET；时间日历 API 与 MCP 需要密钥、按调用扣积分。左侧选一节，右侧每个接口都能填密钥直接试。

GET /api/v1/me/*

登录后在日历里记的备注、标记、倒数日与常用网址，也能用密钥读写 —— 需要 me:read / me:write 权限。GET /api/v1/me 列出全部资源地址。下面调试栏只发 GET，避免误把整份数据覆盖掉。

API Key

填入后，下面每个接口都可以直接发送。密钥只存在这个标签页里，关掉即清。在 API 令牌创建。每次成功鉴权的调用扣 1 积分，参数写错也会扣。

# 读某天的备注
curl -H "Authorization: Bearer ha_pat_xxx" \
  "https://handapp.com/api/v1/me/notes?date=2026-08-16"

# 整体替换备注（PUT 是全量覆盖，不是追加）
curl -X PUT -H "Authorization: Bearer ha_pat_xxx" \
  -H "content-type: application/json" \
  -d '{"notes":{"2026-08-16":[{"id":"n1","text":"体检","ts":1755000000000}]}}' \
  "https://handapp.com/api/v1/me/notes"

资源有 markers、notes、countdowns、favorites、prefs 五个。常用网址是按条合并，payload 里没出现的条目不会被删；要隐藏请带 deleted: true。其余资源的 PUT 是整体替换：先 GET 拿到当前值、改完再整份写回，别指望它合并。在浏览器里登录着直接访问这些地址也可以，那条路径走会话 Cookie，不扣积分 —— 对自己的界面操作收费没有道理，收费的是程序化访问。

GET /api/v1/me

列出当前密钥对应用户的个人资源地址

GET /api/v1/me/notes

读备注。可带 date 查一天，或 from / to 查区间

GET /api/v1/me/markers

读日期标记。可选 from / to 窗口

GET /api/v1/me/countdowns

读倒数日

GET /api/v1/me/favorites

读常用网址

GET /api/v1/me/prefs

读日历偏好