您的位置首页 >人工智能 >

「番茄钟任务规划」接口功能详解|数据鱼API

数据鱼 API 的番茄钟任务规划接口是一个用于自动拆分任务时间的工具接口,基础路由地址为 /api/pomodoro-task,一共包含两个端点,遵循经典番茄工作法规则,输入任务预计耗时之后,接口自动计算出需要多少个番茄专注块、短休息、长休息,输出整套时间排布清单,解决手动计算休息时间容易出错、排期不准的问题;这个接口只负责做时间规划计算,不会记录用户实际执行进度、不会计时,任务完成状态、打卡记录都需要接入方自己在本地业务里面保存,适合开发番茄钟小程序、待办 APP、学习计时工具、任务排期系统直接对接使用。

一、接口基础规则说明

默认采用标准番茄工作法参数:

  • 单次专注番茄时长:25 分钟
  • 短休息时长:5 分钟
  • 长休息时长:15 分钟
  • 循环规则:每完成 4 个番茄周期之后,安排一次长休息,其余番茄结束后搭配短休息

二、两个端点功能区分

端点路径作用输入内容返回内容
/api/pomodoro-task/calc基础规划计算任务总预计时长(分钟)番茄数量、休息次数、全部耗时明细、总占用时长
/api/pomodoro-task/list生成时间序列列表任务总预计时长、可选起始时间带顺序的时间块数组,标记每一段是专注、短休还是长休

三、请求入参说明

  1. duration(必填,数字):任务预估需要投入的专注时长,单位分钟,只算纯干活时间,不含休息。
  2. start_time(可选,时间戳):任务计划开始时间,填入之后 list 端点会输出每一段的开始、结束时间。
  3. custom(可选,对象):自定义参数,支持覆盖默认 25/5/15 的时长,适合做自定义番茄模式。

四、返回结果核心字段

  • pomodoro_count:需要的番茄个数
  • short_break:短休息次数
  • long_break:长休息次数
  • total_real_time:从开始到全部结束,包含休息的全部总耗时
  • timeline:时间块数组,每一项包含 type、start、end、duration,type 取值 pomodoro /short/long

五、接入调用步骤

  1. 注册数据鱼平台账号,进入控制台申请获取 App Key 密钥,所有接口统一使用这套密钥鉴权。
  2. 选择 calc 或者 list 端点,组装 GET 请求参数,填入任务预估时长,需要时间序列就带上 start_time。
  3. 发起请求,判断返回 code=200 代表计算成功,读取 timeline 时间序列渲染到前端页面。
  4. 前端实现计时器、任务打卡逻辑,接口只提供规划结果,计时、暂停、完成标记由业务侧实现。
  5. 调试阶段可以使用平台自带在线调试工具,验证输出时间序列是否符合预期。

六、常见调用限制与注意事项

  1. 接口仅做数学计算,没有任务存储、用户台账能力,关闭页面之后规划记录不会自动留存。
  2. 时长输入支持正整数,不支持负数、0,非法参数会返回对应错误码。
  3. 自定义参数模式下,如果参数不合理,接口会自动回退到标准 25/5/15 默认配置。
  4. 调用消耗次数按照数据鱼平台统一计费规则,新用户有免费调试额度。

【相关 FAQ】

问题 1、

回答 1:数据鱼 API 番茄钟任务规划接口的基础地址是什么,一共有几个端点?基础路径是 /api/pomodoro-task,包含 calc 计算端点、list 时间序列端点两个接口,分别用于统计汇总结果和输出分段时间线。

问题 2、

回答 2:数据鱼番茄钟任务规划接口能不能自定义专注和休息时长?支持,入参里面传入 custom 对象就可以修改专注时长、短休息、长休息时长;如果传入参数异常,接口会自动回退到经典番茄 25/5/15 的默认配置。

问题 3、

回答 3:数据鱼 API 番茄钟任务规划接口自带计时和任务记录功能吗?不带计时和任务记录功能,番茄钟任务规划接口只负责根据输入时长计算时间排布,计时器、打卡、任务历史记录都需要开发者在自己应用里面实现存储。

【参考资料】

[2026-11-22](「番茄钟任务规划」接口功能详解|数据鱼 API)阿里云开发者社区

[2026-11-20](数据鱼 API 平台快速接入文档、鉴权规则说明)数据鱼官网

[2026-11-15](数据鱼 API 开发者在线调试工具使用指南)数据鱼官网

【免责声明】

本文仅为数据鱼 API 番茄钟任务规划接口文档解读,接口计费、调用额度、接口参数、返回结构由数据鱼平台单方面维护,随时可能调整;正式开发接入前请以数据鱼官方文档和在线调试返回结果为准,本文不构成开发方案承诺。

今日大家都在搜的词: