Adapty Developer CLI 完整参考

正在使用 AI 助手？可以使用 Adapty CLI skill 帮助 LLM 与 CLI 配合工作。

本文列出了所有 Adapty CLI 命令及其参数、标志和可接受的值。

有关身份验证设置和令牌管理，请参阅身份验证。

全局标志

这些标志适用于所有命令。

标志	描述
`--json`	以 JSON 格式输出，而非格式化文本
`--help`	显示命令帮助

所有 list 命令还接受分页标志：

标志	默认值	描述
`--page`	`1`	页码
`--page-size`	`20`	每页条目数（最大：100）

应用

管理 Adapty 账户中的应用。有关基于看板的配置，请参阅 App settings。

adapty apps list

列出 Adapty 账户中的所有应用。

adapty apps list

接受分页标志。

adapty apps get

获取特定应用的详细信息。

adapty apps get <app-id>

参数	描述
`app-id`	应用 ID（UUID）

adapty apps create

创建新应用。

adapty apps create --title "My App" --platform ios --apple-bundle-id com.example.app

标志	是否必填	描述
`--title`	是	应用标题
`--platform`	是	平台：`ios` 或 `android`。重复使用以支持两者：`--platform ios --platform android`
`--apple-bundle-id`	与 `--platform ios` 一起使用时必填	Apple bundle ID
`--google-bundle-id`	与 `--platform android` 一起使用时必填	Google bundle ID

adapty apps update

更新现有应用。

adapty apps update <app-id> --title "New Name"

参数	描述
`app-id`	应用 ID（UUID）

标志	描述
`--title`	新的应用标题
`--apple-bundle-id`	新的 Apple bundle ID
`--google-bundle-id`	新的 Google bundle ID

至少需要一个标志。--platform 在创建后无法更改。

访问等级

adapty access-levels list

列出应用的所有访问等级。

adapty access-levels list --app <app-id>

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

接受分页标志。

adapty access-levels get

获取特定访问等级的详细信息。

adapty access-levels get --app <app-id> <access-level-id>

参数	描述
`access-level-id`	访问等级 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

adapty access-levels create

创建新的访问等级。

adapty access-levels create --app <app-id> --sdk-id "pro" --title "Pro"

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--sdk-id`	是	应用代码中用于检查访问权限的标识符（例如 `"pro"` 或 `"premium"`）
`--title`	是	Adapty 看板中的显示标签

adapty access-levels update

更新现有访问等级。

adapty access-levels update --app <app-id> <access-level-id> --title "Pro Access"

参数	描述
`access-level-id`	访问等级 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	是	新的显示标签

--sdk-id 在创建后无法更改。

产品

adapty products list

列出应用的所有产品。

adapty products list --app <app-id>

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

接受分页标志。

adapty products get

获取特定产品的详细信息。

adapty products get --app <app-id> <product-id>

参数	描述
`product-id`	产品 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

adapty products create

创建新产品。

商店产品 ID（--ios-product-id、--android-product-id、--android-base-plan-id）在创建后无法更改。如需使用不同的商店产品 ID，请创建新产品。

adapty products create --app <app-id> --title "Monthly" --access-level-id <access-level-id> --period monthly --ios-product-id com.example.monthly

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	是	产品标题
`--access-level-id`	是	此产品解锁的访问等级 ID（UUID）
`--period`	是	订阅周期：`weekly`、`monthly`、`2_months`、`3_months`、`6_months`、`yearly`、`lifetime`
`--ios-product-id`	至少需要一个平台	App Store Connect 中的产品 ID
`--android-product-id`	至少需要一个平台	Google Play Console 中的产品 ID
`--android-base-plan-id`	与 `--android-product-id` 一起使用时必填，除非设置了 `--period lifetime`	Google Play Console 中的基础方案 ID

adapty products update

更新现有产品。

商店产品 ID（--ios-product-id、--android-product-id）在创建后无法更改，此命令中不可用。如需使用不同的商店产品 ID，请创建新产品。

adapty products update --app <app-id> <product-id> --title "Monthly" --access-level-id <access-level-id>

参数	描述
`product-id`	产品 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	否	产品标题
`--access-level-id`	否	此产品解锁的访问等级 ID（UUID）

付费墙

adapty paywalls list

列出应用的所有付费墙。

adapty paywalls list --app <app-id>

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

接受分页标志。

adapty paywalls get

获取特定付费墙的详细信息。

adapty paywalls get --app <app-id> <paywall-id>

参数	描述
`paywall-id`	付费墙 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

adapty paywalls create

创建新付费墙。

adapty paywalls create --app <app-id> --title "Default Paywall" --product-id <product-id>

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	是	付费墙标题
`--product-id`	是	产品 ID（UUID）。重复使用以支持多个产品：`--product-id <id1> --product-id <id2>`

adapty paywalls update

替换现有付费墙的所有字段。

付费墙一旦与版位关联，其产品便无法更改。如需在已上线的付费墙中使用不同产品，请创建新付费墙并更新版位以指向新付费墙。

adapty paywalls update --app <app-id> <paywall-id> --title "Default Paywall" --product-id <product-id>

此命令将替换付费墙的所有字段，包括完整的产品列表。

参数	描述
`paywall-id`	付费墙 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	是	付费墙标题
`--product-id`	是	产品 ID（UUID）。重复使用以支持多个产品：`--product-id <id1> --product-id <id2>`

版位

adapty placements list

列出应用的所有版位。

adapty placements list --app <app-id>

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

接受分页标志。

adapty placements get

获取特定版位的详细信息。

adapty placements get --app <app-id> <placement-id>

参数	描述
`placement-id`	版位 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）

adapty placements create

创建新版位。

adapty placements create --app <app-id> --title "Main" --developer-id "main" --paywall-id <paywall-id>

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	是	版位标题
`--developer-id`	是	应用代码中用于请求此版位的字符串标识符
`--paywall-id`	是	在此版位显示的付费墙 ID（UUID）

adapty placements update

替换现有版位的所有字段。

adapty placements update --app <app-id> <placement-id> --title "Main" --developer-id "main" --paywall-id <paywall-id>

参数	描述
`placement-id`	版位 ID（UUID）

标志	是否必填	描述
`--app`	是	应用 ID（UUID）
`--title`	是	版位标题
`--developer-id`	是	应用代码中用于请求此版位的字符串标识符
`--paywall-id`	是	在此版位显示的付费墙 ID（UUID）

身份验证

命令	描述
`adapty auth login`	通过浏览器使用设备流进行身份验证
`adapty auth logout`	清除本地存储的凭据
`adapty auth whoami`	向服务器验证令牌并显示用户信息
`adapty auth status`	不发起服务器调用，显示本地身份验证状态
`adapty auth revoke`	在服务器端撤销令牌并在本地清除

有关每个命令的完整详情，请参阅身份验证。