PingCode 研发管理 API

解决的问题

PingCode 中的工作项、项目、迭代、评论和工时分散在大量 REST 接口里，人工翻页、跨端点取数和写周报脚本容易重复劳动；私有部署下 /open 路径配置稍差，请求也可能返回前端 HTML 而非 JSON。

工作方式

该技能把 PingCode Open API 封装成可配置的数据访问层：

• 用 PINGCODE_BASE_URL 与 PINGCODE_OAUTH2_ROOT 区分公有云和私有部署地址。
• 支持 企业令牌 访问企业级数据，也支持 用户令牌 访问“我的工作项”等个人数据。
• 通过通用调用器覆盖 588 个接口、70 个分组，可先查分组再调用目标端点。
• 常用场景已有脚本化入口，如项目列表、工作项增删改查、迭代、评论、工时和周报生成。

适用边界

• 请求频率上限为 每分钟 200 次，令牌有效期约 30 天。
• 列表分页时部分接口会忽略 page_size，且 total 不一定准确，遍历应以实际返回条数判断结束。
• 私有部署需明确 API 根地址带 /open，授权根地址通常不带 /open。
• 凭证写入本地 .env，企业令牌与用户令牌凭证应分开配置。