生成可信的每周简报
把任务、日期、时间块、优先级、标签、备注和完成状态接入仪表盘、报告或 AI 智能体上下文。
任务计划 API
让自动化接入一份真正有人使用的计划
让 AI 智能体、脚本或工作流结构化访问你在 WeeklyPlanner 中使用的同一套任务、分组、设置和计划数据。
JSON REST endpoints可撤销的 scoped keys共用同一份计划数据
真实计划，不是伪造集成界面
AI 助手通过受限连接操作你的计划
在 WeeklyPlanner 中创建可撤销密钥，连接兼容的 Agent，让工作流读取或更新你在应用中也能检查的同一份计划。
- 你的请求
- Task Planner Skill
- 受限 MCP 或 API
- WeeklyPlanner 计划
你可以自动化什么
当工作流需要读取或修改真实计划，而不是再导出一份待办清单副本时，这套 API 才真正有价值。
承接其他系统产生的工作
把审核通过的表单、消息或 workflow events 转成带日期、分组、优先级和时间块的计划任务。
计划变化后重新平衡
把选定任务移动到其他日期或时间块，批量更新字段，同时只维护一份真实数据源。
复盘实际发生的结果
结合计划统计、已完成任务和顺延事项，生成基于账号真实数据的周回顾。
可连接的计划能力
这些是任务计划操作，不是日历服务商的 event sync。每次请求都作用于已认证账号自己的计划数据。
任务与循环系列
筛选、创建、查看、更新、删除、排序和批量调整任务，并通过专用操作管理循环系列。
分组
读取并维护计划工具中用于组织任务的分组名称、颜色和顺序。
设置与个人资料
读取或更新计划偏好、语言、视图设置和部分个人计划上下文。
统计与订阅上下文
读取任务聚合统计和当前订阅上下文，供仪表盘展示或 AI 智能体决策使用。
安全与权限边界
每个连接单独使用一把 API key，并且只授予该工作流真正需要的操作权限。
Bearer API keys
在 Settings 创建 key，在明文值显示时立即保存，并通过 Authorization header 发送。不要把它写进客户端代码或提示词。
分离读写 scopes
报告类工作流可以保持只读；只有集成确实需要创建、移动、编辑或删除计划数据时，才增加写入 scopes。
独立撤销每个连接
为每个 AI 智能体、脚本或自动化创建不同的 key，停用某个工作流时不会中断其他连接。
每次请求都校验并限流
API 会认证调用方、检查所需 scopes、校验输入，并应用该账号的外部 API/MCP 请求限额。
可用 API scopes
这些 scopes 直接来自 Settings 创建 key 时使用的同一套应用常量。
tasks:readtasks:writegroups:readgroups:writestats:readsettings:readsettings:writeprofile:readprofile:write外部请求额度
REST API 与 MCP 调用共用外部请求池；内置 AI 对话轮次单独计量。
- 免费版每滚动 24 小时包含 100 次外部 API/MCP 请求
- Pro 与终身版每小时包含 1,000 次外部 API/MCP 请求
你可能根本不需要写 API 代码
先用维护成本最低的连接方式验证工作流是否有价值，再决定是否长期维护自定义集成。
使用内置 AI 计划助手
直接用自然语言获取总结或提出排期调整，不需要创建和保存外部 API key。
了解 AI 计划助手配置 MCP server
通过已发布的 package 和 scoped key 接入 Claude 等兼容客户端，不必自己编写 REST calls。
查看 MCP 指南直接使用计划工具
如果只是个人使用且没有重复集成需求，可视化周计划更简单，长期维护成本也更低。
打开周计划REST API 快速开始
请在 server-side environment 或 secret manager 中使用 key。以下示例通过 scoped key 直接调用公开 v1 API。
1. 创建 scoped key
打开 Settings，为这个集成单独创建 key，并选择最小化的读取或写入 scope 集合。
2. 存入源码之外
立即把明文 key 保存到自动化系统的 server-side secret store；它不是可以暴露在浏览器里的凭据。
3. 先发起只读请求
读取一个较窄的日期范围，确认响应结构，再按实际需要增加写入 scopes 和 mutation calls。
读取一周任务
按包含首尾日期的范围筛选，响应使用顶层 data 字段。
curl "https://weeklyplanner.cc/api/v1/tasks?date_from=2026-08-03&date_to=2026-08-09" \
-H "Authorization: Bearer wp_your_api_key" \
-H "Content-Type: application/json"创建计划任务
写入请求需要 tasks:write，并受该账号正常产品限额约束。
curl -X POST "https://weeklyplanner.cc/api/v1/tasks" \
-H "Authorization: Bearer wp_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"title": "准备每周回顾",
"date": "2026-08-07",
"time_block": "evening",
"priority": "high"
}'核心 endpoint 参考
下方聚焦稳定的计划 endpoints。除后面列出的通用响应外，具体 route 的参数校验还可能返回更精确的 4xx codes。
任务与循环系列
读取和修改单个任务、应用批量更新、保存排序，并明确管理循环系列。
GET /api/v1/tasksPOST /api/v1/tasksGET|PATCH|DELETE /api/v1/tasks/:idPOST /api/v1/tasks/batchPOST /api/v1/tasks/reorderGET|PATCH|DELETE /api/v1/series/:id分组
读取和创建分组，并查看、编辑或删除一个分组。
GET|POST /api/v1/groupsGET|PATCH|DELETE /api/v1/groups/:id设置与个人资料
读取或更新计划偏好和部分个人资料上下文。
GET|PATCH /api/v1/settingsGET|PATCH /api/v1/user/profile统计与订阅
读取任务聚合统计和当前订阅状态。
GET /api/v1/statsGET /api/v1/subscription/status常见响应与 error codes
资源请求成功时使用顶层 data 字段；错误响应包含机器可读的 code 和面向人的 error message。
validation_failedquery 或 JSON body 未通过 schema 或领域规则校验；可以检查可选的 details 字段。
unauthorizedBearer credential 缺失、无效、已过期或已经停用。
missing_scopekey 本身有效，但不包含当前操作要求的 scope。
not_found请求的账号资源不存在，或当前调用方无权看到它。
rate_limit_exceeded外部请求额度已经耗尽。存在 Retry-After 时应遵循该 header，不要用紧密 retry loop 重复调用。
rate_limit_unavailable原子限流预留暂时不可用，API 会失败关闭，并要求客户端稍后重试。
internal_error发生意外 server error。收集诊断信息时不要暴露或记录 API key。
继续查看相关页面
任务计划 API 常见问题
- 这是日历 API 吗？
- 不是。这是用于访问 WeeklyPlanner 中任务、分组、设置、个人资料上下文和统计数据的计划与任务 API，不是日历服务商的 events 或 availability API。
- 连接 AI 助手必须写代码吗？
- 不一定。内置 AI 计划助手不需要外部 key；MCP package 也能通过配置为兼容客户端提供结构化工具，不必自己编写 REST 代码。
- API key 可以修改我的计划吗？
- 只有具备对应 write scope 时才可以。摘要和报告使用只读 scopes，并为每个连接单独创建 key。
- REST API 和 MCP 有各自独立的额度吗？
- 没有。二者共用该账号的外部 API/MCP 请求池；内置 AI 对话轮次是另一套独立额度。