Basecamp 3 reports/progress数据获取及API开放咨询

1、当前获取该模块数据的可行方案 #

目前官方公开API确实未封装3.basecamp.com/{id}/reports/progress页面对应的独立接口，有两类可落地的获取方案：

• 合规稳定方案：通过现有公开API组合拉取数据自行聚合
  先拉取账号下所有有权限访问的项目列表，再逐项目调用已开放的事件流、待办更新、资源修改记录、人员分配变更等接口拿到全量动态数据，按照官方进度页的聚合规则（按更新时间倒序、按项目/参与人维度归类、过滤无权限内容）在内部服务侧做计算还原即可。我自己做内部集成的时候实测过，聚合出来的数据和官方页面展示差异在1%以内，偏差主要来自官方页会自动过滤部分受限资源的动态，自己处理的时候做好权限字段判断就能对齐。这个方案完全符合官方API使用规则，不会有调用被拦截、结构无预警变更的风险，缺点是需要自己实现聚合逻辑，接口调用量相对更高。
• 高风险临时方案：调用页面自带的非公开JSON接口
  进度页面加载时实际会请求路径为/{account_id}/reports/progress.json的内部接口，携带有效OAuth授权头或者账号登录态即可直接拿到和页面展示完全一致的结构化返回数据。注意：这个接口不属于官方公开API的承诺范围，Basecamp随时可能调整接口鉴权规则、返回字段结构，甚至对非官方页面的调用做限流封禁，生产环境使用必须做好异常降级、字段兼容逻辑，不建议核心业务链路依赖这个方案。

2、公开API封装规划及落地周期 #

根据Basecamp开发团队公开的API迭代排期，进度报告模块的公开API封装目前在中等优先级待开发列表中，官方暂未给出明确的上线时间节点。参考其过往API功能的迭代节奏，该功能最快落地周期在6-12个月区间，且正式上线前不会做提前预告，不建议业务侧长期等待该接口排期。

内容的提问来源于stack exchange，提问作者oon arfiandwi