为终端而生的 AppGallery Connect 控制面

让每一次发布沿着 同一条红线前进。

用一套 Go 命令发现、预演并调用 AppGallery Connect API,为开发者、CI 和 Coding Agent 提供稳定 JSON。

21 API 家族286 已注册接口3 输出格式
agc / production参考模式
agc终端命令JSONAgent脚本
一个命令入口,连接你的工作流。
鉴权PS256 / OAuth
PROFILE项目自动绑定
软件包上传与状态
发布确认后调用

$ agc auth check --pretty

{
  "data": {
    "name": "production",
    "mode": "service-account",
    "active": true
  },
  "affordances": {
    "next": "agc publishing endpoints"
  }
}

已解析项目 Profile · 默认 dry-run

默认预演明确确认前不会发送请求。
Agent 可读JSON 返回下一步可执行操作。
统一控制面CLI、本地 REST 与 Web 共用注册表。

安装 agc CLI

用系统包管理器安装。

Windows、macOS 和 Linux CI 可通过同一条 NPM 命令无人值守安装。开发电脑仍可使用 Homebrew 或 Scoop 原生包。

Windows · macOS · Linux CI
$ npm install --global @createitv/agc-cli && agc version
macOS Homebrew 命令
$ brew tap createitv/tap && brew install agc-cli && agc version
Windows Scoop 命令
PS> if (!(Get-Command scoop -ErrorAction SilentlyContinue)) { Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; irm get.scoop.sh | iex }; scoop bucket add createitv https://github.com/Createitv/scoop-bucket; scoop install agc-cli; agc version
NPM:Node.js 18+ 安装时不运行 postinstall 下载 内置五个平台校验后二进制

Agent Skills

让 Coding Agent 真正理解 AppGallery Connect 工作流。

6 个可移植 Skills 参考 asc-cli 的任务分层方式设计。可以全部安装,也可以只选择一个工作流;每个 Skill 都支持查看源码、直接下载和通过 GitHub 参与完善。

提交一个 Skill
为 Codex 安装全部 6 个 Skills$ agc skills install --agent codex --global
agc-cli-usage

通用命令发现、dry-run 预演、授权执行和远程结果验证。

agc skills install --name agc-cli-usage --agent codex --global
agc-auth

凭据 Profile、whoami、OAuth 团队查询和权限诊断。

agc skills install --name agc-auth --agent codex --global
agc-publishing

应用资料、软件包、提交审核、分阶段发布和发布状态验证。

agc skills install --name agc-publishing --agent codex --global
agc-testing

测试版本、群组、测试用户、邀请链接、反馈和版本转正。

agc skills install --name agc-testing --agent codex --global
agc-reports

分发、安装、付费、留存和鸿蒙元服务报表导出。

agc skills install --name agc-reports --agent codex --global
agc-cicd

跨平台固定版本安装、受保护凭据、dry-run 门禁和 CI 验证。

agc skills install --name agc-cicd --agent codex --global

发布轨道

上下文向前流动,密钥留在本地。

每个阶段只完成一件事。凭据保存在本机,项目上下文可以安全共享,写入类 API 必须显式确认。

01

鉴权

PS256 / OAuth

02

PROFILE

项目自动绑定

03

软件包

上传与状态

04

发布

确认后调用

Profile 自动绑定

每个项目只选择一次,临时切换时再覆盖。

在 .agc/project.json 中绑定 production。命令会按固定优先级解析,也可以用 --profile staging 完成一次性切换。

  1. 1命令行显式覆盖--profile staging
  2. 2项目默认 Profile.agc/project.json
  3. 3全局激活账户~/.agc/credentials.json
.agc/project.json 可安全提交
{
  "appId": "123456789",
  "projectId": "987654321",
  "packageName": "com.example.app",
  "profile": "production"
}
项目文件不保存 client key 或私钥。

接口注册表

先发现 API,再编写请求。

每个条目都包含 method、path、参数位置、CLI 命令、REST 路由和 dry-run 调用方式。

当前家族 / cloud-auth

认证服务

已注册

应用用户认证及服务端用户管理,与开发者登录分开。

发现agc cloud-auth endpoints --output table
状态agc cloud-auth status --pretty
本地 REST/api/v1/cloud-auth
17 个类型化接口条目

全部接口 17

展开接口查看已登记参数与命令;完整协议、响应字段及权限以官方文档为准。

POST导入用户import-users/api/auth-service/v1/server/user:import

此接口用于将准备好的用户信息导入到认证服务的用户数据中。

开发者调用华为 API

已登记参数
参数位置必填类型说明
productIdheader是string项目ID,查询方法可参见查询项目ID。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。
client_idheader否string客户端ID,获取方法参考创建API客户端。
usersbody是array第三方的认证信息。

请求体: users

查看接口定义

agc cloud-auth import-users --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/import-users

调用预演(先填写所需参数)

agc cloud-auth import-users --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST导出用户export-users/api/auth-service/v1/server/user:export

此接口用于导出认证服务中的用户信息。

开发者调用华为 API

已登记参数
参数位置必填类型说明
productIdheader是string项目ID,查询方法可参见查询项目ID。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。
client_idheader否string客户端ID,获取方法参考创建API客户端。
blockbody否—当前存储块号。不填默认是0。第1次调用时,block设置为0。服务端会返回totalBlock。后面采用循环调用,遍历导出block块里面的用户。 Documented String/example integer conflict; accepted without coercion.

请求体: block

查看接口定义

agc cloud-auth export-users --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/export-users

调用预演(先填写所需参数)

agc cloud-auth export-users --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
GET验证用户凭据verify-token/api/oauth2/third/v1/verify-token

此接口用于验证已经颁发的用户凭据并且检查用户凭据是否已经撤销。

开发者调用华为 API

已登记参数
参数位置必填类型说明
accessTokenheader是string用户凭据。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。
client_idheader否string客户端ID,获取方法参考创建API客户端。
productIdquery是string项目ID,查询方法可参见查询项目ID。

查看接口定义

agc cloud-auth verify-token --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/verify-token

调用预演(先填写所需参数)

agc cloud-auth verify-token --invoke --dry-run=true
查看接口参考文档 ↗
POST撤销用户凭据revoke-token/api/oauth2/third/v1/revoke-token

此接口用于撤销已经颁发的用户访问凭据。

开发者调用华为 API

已登记参数
参数位置必填类型说明
uidheader是string待撤销凭据的用户。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。
client_idheader否string客户端ID,获取方法参考创建API客户端。
productIdquery是string项目ID,查询方法可参见查询项目ID。

请求体: json

查看接口定义

agc cloud-auth revoke-token --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/revoke-token

调用预演(先填写所需参数)

agc cloud-auth revoke-token --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST获取Tokenclient-token/agc/apigw/oauth2/v1/token

在使用客户端REST API调用业务接口前,需要通过华为开放平台进行鉴权,并获取认证通过后的Token。

开发者调用华为 API

已登记参数
参数位置必填类型说明
useJwtbody是integer是否使用自有账号凭据JWT(Json Web Token): 1:使用JWT。 0:不使用,默认为0。
grant_typebody是string固定传入“client_credentials”。
client_idbody是string客户端ID,即获取客户端API授权中的“Client ID”。
client_secretbody是string客户端密钥,即获取客户端API授权中的“Client Secret”。

请求体: useJwt,grant_type,client_id,client_secret

查看接口定义

agc cloud-auth client-token --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/client-token

调用预演(先填写所需参数)

agc cloud-auth client-token --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST验证码申请request-code/agc/apigw/oauth2/third/v1/verify-code

此接口用于用户注册、登录或者重置密码时验证码申请。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
productIdquery是string项目ID,查询方法可参见查询项目ID。
phonebody否string手机号。需包含国家码,以“+”开头,国家码和手机号之间以“-”连接,例如中国大陆手机号“+86-150xxxxxxxx”。
emailbody否string电子邮箱。 电子邮箱和手机号码二者必填一个。
actionbody否integer验证码行为,取值如下: 1001:注册登录时申请验证码。 1002:重置密码时申请验证码。
langbody否string语言,格式为“zh_CN”。所有支持的语言类型请参考认证服务验证码语言类型。
sendIntervalbody否integer验证码发送间隔,30s到120s之间。

请求体: phone,email,action,lang,sendInterval

查看接口定义

agc cloud-auth request-code --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/request-code

调用预演(先填写所需参数)

agc cloud-auth request-code --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST用户注册register/agc/apigw/oauth2/third/v1/user-register

此接口用于用户注册。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
productIdquery是string项目ID,查询方法可参见查询项目ID。
phonebody否string手机号,包括国家码,以“+”开头,例如中国大陆的手机号以“+86”开头。
emailbody否string电子邮箱。 电子邮箱和手机号码二者必填一个。
verifyCodebody否string验证码,传入手机号时必填。
passwordbody否string登录密码。
useJwtbody否integer是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。
channelIdbody否string渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。
aaIdbody否string应用实例唯一编号。

请求体: phone,email,verifyCode,password,useJwt,channelId,aaId

查看接口定义

agc cloud-auth register --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/register

调用预演(先填写所需参数)

agc cloud-auth register --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST用户密码登录sign-in-password/agc/apigw/oauth2/third/v1/user-signin

此接口用于用户使用密码登录。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerbody是integer账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。
tokenbody是string手机号码或者邮箱账号。
extraDatabody否string扩展字段,此处用于密码登录时填写密码,填写样例如 {\"password\":\"xxxxxxxxx\"}。
autoCreateUserbody否integer是否自动创建用户,仅用于非托管账号: 0:不自动创建。 1:自动创建,默认为1。
useJwtbody否integer是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。
channelIdbody否string渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。
aaIdbody否string应用实例唯一编号。

请求体: provider,token,extraData,autoCreateUser,useJwt,channelId,aaId

查看接口定义

agc cloud-auth sign-in-password --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/sign-in-password

调用预演(先填写所需参数)

agc cloud-auth sign-in-password --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST用户验证码登录sign-in-code/agc/apigw/oauth2/third/v1/user-signin

此接口用于用户使用验证码登录。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerbody是integer账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。
tokenbody是string手机号码或者邮箱账号。
extraDatabody否string扩展字段,此处用于验证码登录时填写验证码,填写样例如 {\"verifyCode\":\"123456\"}。
autoCreateUserbody否integer是否自动创建用户,仅用于非托管账号: 1:自动创建,默认为1。 0:不自动创建。
useJwtbody否integer是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。
channelIdbody否string渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。
aaIdbody否string应用实例唯一编号。

请求体: provider,token,extraData,autoCreateUser,useJwt,channelId,aaId

查看接口定义

agc cloud-auth sign-in-code --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/sign-in-code

调用预演(先填写所需参数)

agc cloud-auth sign-in-code --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT修改手机号或邮箱地址update-account/agc/apigw/oauth2/third/v1/user-phone-email

此接口用于用户修改手机号码或者邮箱地址。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
access_tokenheader是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。
productIdquery是string项目ID,查询方法可参见查询项目ID。
langbody否string语言,格式为“zh_CN”。
newPhonebody否string新手机号。
newEmailbody否string新邮箱地址。 新邮箱地址和新手机号必填一个且只能填一个,即一次只修改手机号或者只修改邮箱地址。
newVerifyCodebody是string新验证码。

请求体: lang,newPhone,newEmail,newVerifyCode

查看接口定义

agc cloud-auth update-account --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/update-account

调用预演(先填写所需参数)

agc cloud-auth update-account --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST重置密码reset-password/agc/apigw/oauth2/third/v1/reset-password

此接口用于用户进行密码重置。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerbody否integer账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。
accountbody否string用户手机账号或者邮箱账号。
verifyCodebody否string验证码。
passwordbody否string新密码。

请求体: provider,account,verifyCode,password

查看接口定义

agc cloud-auth reset-password --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/reset-password

调用预演(先填写所需参数)

agc cloud-auth reset-password --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
PUT修改密码update-password/agc/apigw/oauth2/third/v1/user-password

此接口用于用户进行密码修改。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
access_tokenheader是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerbody否integer账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。
verifyCodebody否string验证码。
newPasswordbody是string新密码。

请求体: provider,verifyCode,newPassword

查看接口定义

agc cloud-auth update-password --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/update-password

调用预演(先填写所需参数)

agc cloud-auth update-password --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST用户关联link-user/agc/apigw/oauth2/third/v1/user-link

此接口用于用户进行账号关联操作。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
access_tokenheader是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerbody是integer账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。
tokenbody是string手机号码或者邮箱账号。
extraDatabody否string扩展字段,此处用于账号关联时填写密码,填写样例如{\"password\":\"xxxxxxxxx\"}。
autoCreateUserbody否integer是否自动创建用户,仅用于非托管账号: 1:自动创建,默认为1。 0:不自动创建。
useJwtbody否integer是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。
channelIdbody否string渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。
aaIdbody否string应用实例唯一编号。

请求体: provider,token,extraData,autoCreateUser,useJwt,channelId,aaId

查看接口定义

agc cloud-auth link-user --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/link-user

调用预演(先填写所需参数)

agc cloud-auth link-user --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST取消关联unlink-user/agc/apigw/oauth2/third/v1/user-unlink

此接口用于用户取消账号关联。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
access_tokenheader是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerquery是integer需要取消关联的provider认证方式。

请求体: json

查看接口定义

agc cloud-auth unlink-user --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/unlink-user

调用预演(先填写所需参数)

agc cloud-auth unlink-user --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST登出sign-out/agc/apigw/oauth2/third/v1/user-signout

此接口用于用户进行登出操作。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
productIdquery是string项目ID,查询方法可参见查询项目ID。
refreshTokenbody是string用于刷新accessToken。当accessToken过期后,需要使用refreshToken去获取新的accessToken。
accessTokenbody是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。

请求体: refreshToken,accessToken

查看接口定义

agc cloud-auth sign-out --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/sign-out

调用预演(先填写所需参数)

agc cloud-auth sign-out --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST注销delete-user/agc/apigw/oauth2/third/v1/user-delete

此接口用于用户进行账号注销操作。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
access_tokenheader是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。
productIdquery是string项目ID,查询方法可参见查询项目ID。

请求体: json

查看接口定义

agc cloud-auth delete-user --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/delete-user

调用预演(先填写所需参数)

agc cloud-auth delete-user --invoke --dry-run=true --body body.json
查看接口参考文档 ↗
POST账号重认证reauthenticate/agc/apigw/oauth2/third/v1/user-reauthenticate

此接口用于用户进行账号重认证操作。

开发者调用华为 API

已登记参数
参数位置必填类型说明
client_idheader否string客户端ID,获取方法参考获取客户端API授权。
Authorizationheader否string认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。
access_tokenheader是string认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。
productIdquery是string项目ID,查询方法可参见查询项目ID。
providerbody是integer账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。
tokenbody是string手机号码或者邮箱账号。
extraDatabody否string扩展字段,此处用于账号重认证时填写密码,填写样例如{\"password\":\"xxxxxxxxx\"}。
autoCreateUserbody否integer是否自动创建用户,仅用于非托管账号: 0:不自动创建。 1:自动创建,默认为1。
useJwtbody否integer是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。
channelIdbody否string渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。
aaIdbody否string应用实例唯一编号。

请求体: provider,token,extraData,autoCreateUser,useJwt,channelId,aaId

查看接口定义

agc cloud-auth reauthenticate --pretty

本地 REST 定义地址

/api/v1/cloud-auth/endpoints/reauthenticate

调用预演(先填写所需参数)

agc cloud-auth reauthenticate --invoke --dry-run=true --body body.json
查看接口参考文档 ↗

agc-cli 是什么,适合谁使用?

agc-cli 是 Createitv 开源的华为 AppGallery Connect 命令行工具,安装后的命令名是 agc。它面向鸿蒙和华为应用开发者,将接口发现、凭据 Profile、请求预演与 API 调用组织成可复用命令,适合需要维护应用资料、测试用户、商品和报表的个人开发者与团队。

项目与使用指南: GitHub · 使用指南 · Issues

常见问题

agc-cli 是华为官方工具吗?

不是。agc-cli 是 Createitv 维护的独立开源项目,使用 MIT 许可证。它基于华为 AppGallery Connect API 参考文档组织接口,不代表华为官方产品或官方支持服务。

如何在 macOS、Windows 和 Linux 安装 agc-cli?

已安装 Node.js 18+ 时,三个系统都可运行 npm install --global @createitv/agc-cli。macOS 也可使用 Homebrew,Windows 也可使用 Scoop。安装后运行 agc version 检查版本。

agc-cli 免费吗,需要付费账号吗?

agc-cli 使用 MIT 许可证,可免费使用和修改。调用华为 API 需要自己的 AppGallery Connect 账号、凭据和相应权限;华为平台服务的费用和限制以华为说明为准。浏览官网接口和使用 CLI 查看接口定义无需登录。

如何开始第一次应用信息查询?

先用 agc auth login --service-account-file ~/.agc/service-account.json --name production 保存凭据,再用 agc init --app-id YOUR_APP_ID --default-profile production 绑定项目。运行 agc publishing app-info-query --invoke --query appId=YOUR_APP_ID --query lang=zh-CN 预演请求,确认后增加 --dry-run=false 发送请求。接口要求 client_id 时显式补上请求头。

156 个接口是否都完成了生产验证?

156 表示注册表中的接口条目数量,分属 13 个 API 家族,不代表每个接口都已完成生产验证。注册表展示已登记参数和调用入口;完整请求、响应、权限与业务前置条件以每个接口链接的参考文档为准。

默认 dry-run 会修改我的应用吗?

不会。带 --invoke 的接口命令默认构建并预览请求,不发送远程请求。真实调用需显式设置 --dry-run=false;调用前应检查目标应用、所选凭据和参数。

可以把 agc-cli 用在脚本或 AI Agent 中吗?

可以。默认 JSON 输出适合脚本处理,agc capabilities 和 agc endpoints 提供能力发现;agc web-server 提供本地 REST 接口,agc openapi 导出接口契约。命令模板帮助导航,但不能替代业务状态检查或审核判断。

如何安装 agc-cli 的 Codex 或 Claude Agent Skills?

先安装 agc-cli,再运行 agc skills list 查看 6 个任务型 Skills。使用 agc skills install --agent codex --global 安装全部 Skills,或增加 --name agc-publishing 只安装发布 Skill。也可以从官网直接下载对应的 SKILL.md。

项目 Profile 会自动填入所有接口参数吗?

项目配置可以绑定默认凭据 Profile,临时切换时使用 --profile。应用 ID、语言、请求头和请求体等接口参数仍需按接口要求显式提供。不要将 Service Account 私钥或凭据文件提交到 Git。

按 API 家族浏览完整参考

内容更新:

快速开始

三条命令,建立可检查的项目工作区。

请将占位符替换为 AppGallery Connect 的真实值。第二条命令会让该项目自动选择对应 Profile。

01

保存凭据 Profile

推荐使用 Service Account。密钥会以受限权限保存在 ~/.agc/credentials.json。

$ agc auth login --service-account-file ~/.agc/service-account.json --name production
02

绑定当前项目

保存项目资料与默认凭据 Profile;调用接口时仍按要求填写应用 ID 等参数。

$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production
03

调用前先检查

接口命令默认 dry-run。确认 method 与 URL 后,再明确执行真实请求。

$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false

本地命令中心

浏览器看到的,就是 CLI 使用的同一份注册表。

需要实时能力数据时启动本地 REST 服务;未启动时,官网仍会作为完整参考界面工作。

agc web-server --addr :8421
GET/api/v1/capabilities家族与下一步操作
GET/api/v1/endpoints全部接口条目
GET/api/v1/openapi.json机器可读契约
POST/api/v1/:family/endpoints/:id/invoke默认 dry-run