$ npm install --global @createitv/agc-cli && agc version让每一次发布沿着 同一条红线前进。
用一套 Go 命令发现、预演并调用 AppGallery Connect API,为开发者、CI 和 Coding Agent 提供稳定 JSON。
$ agc auth check --pretty
{
"data": {
"name": "production",
"mode": "service-account",
"active": true
},
"affordances": {
"next": "agc publishing endpoints"
}
}已解析项目 Profile · 默认 dry-run
安装 agc CLI
用系统包管理器安装。
Windows、macOS 和 Linux CI 可通过同一条 NPM 命令无人值守安装。开发电脑仍可使用 Homebrew 或 Scoop 原生包。
$ brew tap createitv/tap && brew install agc-cli && agc versionPS> 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 versionAgent Skills
让 Coding Agent 真正理解 AppGallery Connect 工作流。
6 个可移植 Skills 参考 asc-cli 的任务分层方式设计。可以全部安装,也可以只选择一个工作流;每个 Skill 都支持查看源码、直接下载和通过 GitHub 参与完善。
提交一个 Skill$ agc skills install --agent codex --globalagc-cli-usage通用命令发现、dry-run 预演、授权执行和远程结果验证。
agc skills install --name agc-cli-usage --agent codex --globalagc-auth凭据 Profile、whoami、OAuth 团队查询和权限诊断。
agc skills install --name agc-auth --agent codex --globalagc-publishing应用资料、软件包、提交审核、分阶段发布和发布状态验证。
agc skills install --name agc-publishing --agent codex --globalagc-testing测试版本、群组、测试用户、邀请链接、反馈和版本转正。
agc skills install --name agc-testing --agent codex --globalagc-reports分发、安装、付费、留存和鸿蒙元服务报表导出。
agc skills install --name agc-reports --agent codex --globalagc-cicd跨平台固定版本安装、受保护凭据、dry-run 门禁和 CI 验证。
agc skills install --name agc-cicd --agent codex --global发布轨道
上下文向前流动,密钥留在本地。
每个阶段只完成一件事。凭据保存在本机,项目上下文可以安全共享,写入类 API 必须显式确认。
鉴权
PS256 / OAuth
PROFILE
项目自动绑定
软件包
上传与状态
发布
确认后调用
Profile 自动绑定
每个项目只选择一次,临时切换时再覆盖。
在 .agc/project.json 中绑定 production。命令会按固定优先级解析,也可以用 --profile staging 完成一次性切换。
- 1命令行显式覆盖
--profile staging - 2项目默认 Profile
.agc/project.json - 3全局激活账户
~/.agc/credentials.json
{
"appId": "123456789",
"projectId": "987654321",
"packageName": "com.example.app",
"profile": "production"
}接口注册表
先发现 API,再编写请求。
每个条目都包含 method、path、参数位置、CLI 命令、REST 路由和 dry-run 调用方式。
当前家族 / cloud-auth
认证服务
应用用户认证及服务端用户管理,与开发者登录分开。
agc cloud-auth endpoints --output tableagc cloud-auth status --pretty/api/v1/cloud-auth全部接口 17
展开接口查看已登记参数与命令;完整协议、响应字段及权限以官方文档为准。
POST导入用户import-users/api/auth-service/v1/server/user:import
此接口用于将准备好的用户信息导入到认证服务的用户数据中。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
productId | header | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
users | body | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
productId | header | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
block | body | 否 | — | 当前存储块号。不填默认是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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
accessToken | header | 是 | string | 用户凭据。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
productId | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
uid | header | 是 | string | 待撤销凭据的用户。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${JWT}”。JWT为通过Service Account方式获取授权中获取的鉴权令牌。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
productId | query | 是 | 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
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
useJwt | body | 是 | integer | 是否使用自有账号凭据JWT(Json Web Token): 1:使用JWT。 0:不使用,默认为0。 |
grant_type | body | 是 | string | 固定传入“client_credentials”。 |
client_id | body | 是 | string | 客户端ID,即获取客户端API授权中的“Client ID”。 |
client_secret | body | 是 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
phone | body | 否 | string | 手机号。需包含国家码,以“+”开头,国家码和手机号之间以“-”连接,例如中国大陆手机号“+86-150xxxxxxxx”。 |
email | body | 否 | string | 电子邮箱。 电子邮箱和手机号码二者必填一个。 |
action | body | 否 | integer | 验证码行为,取值如下: 1001:注册登录时申请验证码。 1002:重置密码时申请验证码。 |
lang | body | 否 | string | 语言,格式为“zh_CN”。所有支持的语言类型请参考认证服务验证码语言类型。 |
sendInterval | body | 否 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
phone | body | 否 | string | 手机号,包括国家码,以“+”开头,例如中国大陆的手机号以“+86”开头。 |
email | body | 否 | string | 电子邮箱。 电子邮箱和手机号码二者必填一个。 |
verifyCode | body | 否 | string | 验证码,传入手机号时必填。 |
password | body | 否 | string | 登录密码。 |
useJwt | body | 否 | integer | 是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。 |
channelId | body | 否 | string | 渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。 |
aaId | body | 否 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | body | 是 | integer | 账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。 |
token | body | 是 | string | 手机号码或者邮箱账号。 |
extraData | body | 否 | string | 扩展字段,此处用于密码登录时填写密码,填写样例如 {\"password\":\"xxxxxxxxx\"}。 |
autoCreateUser | body | 否 | integer | 是否自动创建用户,仅用于非托管账号: 0:不自动创建。 1:自动创建,默认为1。 |
useJwt | body | 否 | integer | 是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。 |
channelId | body | 否 | string | 渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。 |
aaId | body | 否 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | body | 是 | integer | 账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。 |
token | body | 是 | string | 手机号码或者邮箱账号。 |
extraData | body | 否 | string | 扩展字段,此处用于验证码登录时填写验证码,填写样例如 {\"verifyCode\":\"123456\"}。 |
autoCreateUser | body | 否 | integer | 是否自动创建用户,仅用于非托管账号: 1:自动创建,默认为1。 0:不自动创建。 |
useJwt | body | 否 | integer | 是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。 |
channelId | body | 否 | string | 渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。 |
aaId | body | 否 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
access_token | header | 是 | string | 认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
lang | body | 否 | string | 语言,格式为“zh_CN”。 |
newPhone | body | 否 | string | 新手机号。 |
newEmail | body | 否 | string | 新邮箱地址。 新邮箱地址和新手机号必填一个且只能填一个,即一次只修改手机号或者只修改邮箱地址。 |
newVerifyCode | body | 是 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | body | 否 | integer | 账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。 |
account | body | 否 | string | 用户手机账号或者邮箱账号。 |
verifyCode | body | 否 | string | 验证码。 |
password | body | 否 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
access_token | header | 是 | string | 认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | body | 否 | integer | 账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。 |
verifyCode | body | 否 | string | 验证码。 |
newPassword | body | 是 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
access_token | header | 是 | string | 认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | body | 是 | integer | 账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。 |
token | body | 是 | string | 手机号码或者邮箱账号。 |
extraData | body | 否 | string | 扩展字段,此处用于账号关联时填写密码,填写样例如{\"password\":\"xxxxxxxxx\"}。 |
autoCreateUser | body | 否 | integer | 是否自动创建用户,仅用于非托管账号: 1:自动创建,默认为1。 0:不自动创建。 |
useJwt | body | 否 | integer | 是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。 |
channelId | body | 否 | string | 渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。 |
aaId | body | 否 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
access_token | header | 是 | string | 认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | query | 是 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
refreshToken | body | 是 | string | 用于刷新accessToken。当accessToken过期后,需要使用refreshToken去获取新的accessToken。 |
accessToken | body | 是 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
access_token | header | 是 | string | 认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。 |
productId | query | 是 | 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_id | header | 否 | string | 客户端ID,获取方法参考获取客户端API授权。 |
Authorization | header | 否 | string | 认证信息,格式为“Authorization: Bearer ${access_token}”。access_token为获取Token中获取的access_token。 |
access_token | header | 是 | string | 认证凭据。用户登录成功后,在登录接口的响应参数“accessToken”中获取。 |
productId | query | 是 | string | 项目ID,查询方法可参见查询项目ID。 |
provider | body | 是 | integer | 账号授权提供方,取值及对应认证方式如下: 0:匿名账号 1:华为账号 2:Facebook* 3:Twitter* 4:微信 5:华为游戏 6:QQ 7:微博 8:Google* 9:Google Play Game* 10:自建账号 11:手机 12:邮箱 13:苹果账号 说明 *星号标记的账号类型仅在海外站点支持,当您选择数据处理位置为德国、新加坡或俄罗斯时可以使用这些认证方式。 |
token | body | 是 | string | 手机号码或者邮箱账号。 |
extraData | body | 否 | string | 扩展字段,此处用于账号重认证时填写密码,填写样例如{\"password\":\"xxxxxxxxx\"}。 |
autoCreateUser | body | 否 | integer | 是否自动创建用户,仅用于非托管账号: 0:不自动创建。 1:自动创建,默认为1。 |
useJwt | body | 否 | integer | 是否使用自有账号凭据JWT(Json Web Token): 0:不使用,默认为0。 1:使用。 |
channelId | body | 否 | string | 渠道标识,当前渠道划分为华为渠道、AppStore渠道以及GooglePlay渠道。当从这些渠道SDK登录时,该参数有值。 |
aaId | body | 否 | 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
GEO · AEO · LLMO
面向 AI Agent 的可读取文档
这些公开文件提供项目事实、任务选择、安全边界、Skills 和完整接口契约。Coding Agent 可以直接读取,无需执行 JavaScript、登录或猜测页面结构。
常见问题
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。
保存凭据 Profile
推荐使用 Service Account。密钥会以受限权限保存在 ~/.agc/credentials.json。
$ agc auth login --service-account-file ~/.agc/service-account.json --name production绑定当前项目
保存项目资料与默认凭据 Profile;调用接口时仍按要求填写应用 ID 等参数。
$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production调用前先检查
接口命令默认 dry-run。确认 method 与 URL 后,再明确执行真实请求。
$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false本地命令中心
浏览器看到的,就是 CLI 使用的同一份注册表。
需要实时能力数据时启动本地 REST 服务;未启动时,官网仍会作为完整参考界面工作。
agc web-server --addr :8421/api/v1/capabilities家族与下一步操作/api/v1/endpoints全部接口条目/api/v1/openapi.json机器可读契约/api/v1/:family/endpoints/:id/invoke默认 dry-run