应用目录

通过应用目录接口，可以查询当前客户企业可见的已发布应用，用于在自己的产品中展示应用列表。

查询目录不会购买产品、创建订阅或授予使用权限。

1. 准备当前用户身份

使用用户身份认证取得当前环境的用户 Access Token，并选择用户所属的客户企业。这个共享接口依据当前用户和企业关系读取目录，无需另申请商业 API 产品；应用身份 Token 不能代替客户用户。

curl --request GET \
  --url "${GOODVISION_API_BASE}/open-platform/v1/application-listings" \
  --header "Authorization: Bearer ${GOODVISION_USER_ACCESS_TOKEN}" \
  --header "X-GV-Organization-ID: ${GOODVISION_CUSTOMER_ORGANIZATION_ID}"

2. 读取可见应用

GET /open-platform/v1/application-listings 返回 {"items": [...]}。没有可见应用时，items 为空数组。

每项包含当前发布信息：id、application_id、environment、resource_version 和 OpenAPI 定义的展示字段。平台按当前客户范围筛选公开或企业定向发布项。

sales_offer_refs 提供当前可用销售方案的引用。购买资格、金额和产品开通状态需另行查询。

使用本次响应展示应用。用户切换企业或环境后，清除旧数据并重新查询；应用访问状态以最新响应为准。

3. 错误与重试

状态码	处理方式
401	重新登录
403	检查当前企业成员关系，不修改企业请求头绕过限制
503	显示暂时不可用并提供重试，不展示上一范围的目录

此接口只读，无需 Idempotency-Key。

下一步：第三方 SaaS 订阅与支付 · API 产品

目录入口与登录配置

目录入口是客户打开产品的网址，登录回调接收授权码，两者分别配置。每个产品创建一个应用；用户登录与后台 API 使用同一应用的不同身份。登录后的客户范围见用户与客户空间。

Console 内置接入

应用默认跳转，也支持隔离 iframe 与受信 qiankun 直挂。内置适配均在应用自己的仓库中完成。完整步骤见PC 网页应用，依次完成开发配置、开发测试和审核发布。