HarmonyOS鸿蒙Next中建议明确 Testing API（含邀请码相关接口）的鉴权策略，并评估补充 Service Account 鉴权支持

HarmonyOS鸿蒙Next中建议明确 Testing API（含邀请码相关接口）的鉴权策略，并评估补充 Service Account 鉴权支持 我们在用 AGC API 做 HarmonyOS 应用的邀请测试 CI 自动化分发，整体流程是：

新建测试版本 → 添加软件包 → 更新测试版本（绑包 + 绑群组）→ 提交测试版本 → 查询当前版本分享链接 → 拼接群组邀请码 → 给外部用户扫码安装

主链路（Publishing API + Upload Management API）已经用 Service Account 接入并稳定运行；但在补"拼接邀请码"这一步时，发现一个鉴权能力上的空缺，想反馈一下。

一、业务场景

CI 触发后会自动调 Publishing API 查询测试版本 appInfo.shareLink，再调 Testing API 查询 / 生成群组邀请码，最终拼成 shareLink + invitationCode 供外部测试用户直接扫码使用，避免每次发版人工到 AGC 后台维护邀请码。

二、当前实测情况

用同一套 Service Account JWT（按 AGC 文档示例签 PS256，Authorization: Bearer ${JWT}）调用以下两类接口，行为不一致：

• GET /api/publish/v3/app-info?appId=&releaseType=6&versionId= → HTTP 200，正常返回 appInfo.shareLink
• GET /api/app-test/v1/test-group/invitation-code?groupId= → HTTP 401，ret.code=205524993，msg=client token auth failed

改用 API Client（POST /api/oauth2/v1/token 用 client_credentials 换 access_token，再带 client_id / Authorization / appId）调同一个接口 → HTTP 200，正常返回 invitationCodes[]。

三、对应文档观察

• 邀请码相关三个接口（生成 / 查询 / 停止）的 Header 章节只列了「API 客户端方式」和「OAuth 客户端方式」，没有「Service Account 方式」小节
• 而支持 SA 的接口（例如 Publishing API 的查询应用信息）会明确列出 Service Account方式：Authorization: Bearer ${JWT}

文档与实测行为一致：Testing API 当前看起来整体只接 API Client / OAuth。

四、由此产生的问题

1. 一个完整的 CI 分发流程被动要维护两套凭据：SA（跑 Publishing / Upload）+ API Client（跑 Testing API 邀请码）
2. 两套凭据共存增加了密钥管理、轮换、泄漏面控制的复杂度
3. AGC 官方近期一直在推 Service Account（更细粒度、更现代）作为主推鉴权方式，开发者难以判断「API Client / OAuth 是否仍是长期可用方案」，也就无法决定是否应该把邀请码相关流程长期固化在 API Client 上

五、希望工程师协助确认

1. Testing API（特别是邀请码相关接口）是否计划支持 Service Account 鉴权？如有，是否有大致时间表？
2. 旧的 API Client / OAuth 鉴权方式是否长期保留？是否有下线计划？如果会下线，是否会先在 Testing API 上补齐 SA 支持再下线？
3. 在过渡期，对于"同一业务流程必须混用 SA + API Client 两套凭据"这种场景，官方的推荐做法是什么？

六、环境信息

• 鉴权方式：Service Account（主链路） + API Client（被动引入，仅用于 Testing API 邀请码）
• 测试发布方式：HarmonyOS 测试发布方式（releaseType=6，API≥10）
• 测试类型：邀请测试（testType=3）
• 涉及接口：
  • GET /api/app-test/v1/test-group/invitation-code
  • POST /api/app-test/v1/invitation-code
  • POST /api/app-test/v1/invitation-code/action/stop
• 参考文档：https://developer.huawei.com/consumer/cn/doc/app/agc-help-test-api-add-invite-code-0000002236201342