产品目录

获取 API 资源项目录

GET/v1/products/

接口说明

获取所有已启用的 API 资源项目录，包括接口名称、描述、单价和可见性信息。

主要用途：

查看平台提供的所有 API 接口
了解各接口的计费标准
确认哪些接口对当前用户可见

返回值： 返回 API 资源项数组，每项包含：

id：资源 ID
routeKey：接口路由标识，如 cards.generate
name：接口中文名称
description：接口功能描述
unitPrice：单次调用单价，单位为元，字符串格式以保持精度
visibility：可见性
- public：所有人可见，无需登录即可查看
- authenticated：仅登录用户可见
- restricted：需特定授权的用户可见

资源状态说明：

此接口仅返回 isActive=true 的已启用资源
已禁用的资源不会出现在列表中

授权说明：

此接口为公开接口，无需 API Key 即可调用
此接口不收费

响应结构

200

Default Response

application/json

示例

json

[
  {
    "id": "res_001",
    "routeKey": "cards.generate",
    "name": "卡片生成",
    "description": "根据模板和数据生成卡片图片",
    "unitPrice": "0.10",
    "visibility": "public"
  }
]