Endpoint 目录
读取公开商品目录
GET /api/v1/catalog/products
GET /api/v1/catalog/products
- operationId:
listPublicProducts - 稳定性: stable
- 认证: 无需认证
- 幂等: none
参数
此操作没有声明参数。
请求体
此操作没有声明请求体。
响应与错误
| 状态 | 说明 | Schema |
|---|---|---|
200 | 操作成功 | #/components/schemas/PublicCatalogProductListResponse |
400 | 请求不符合公开契约 | #/components/schemas/PublicErrorResponse |
401 | 认证失败 | #/components/schemas/PublicErrorResponse |
403 | 授权 scope 不足 | #/components/schemas/PublicErrorResponse |
404 | 公开资源不存在 | #/components/schemas/PublicErrorResponse |
409 | 幂等或状态冲突 | #/components/schemas/PublicErrorResponse |
429 | 请求频率受限 | #/components/schemas/PublicErrorResponse |
限流
spec 声明了 429 响应。
Retry-After header 未在 spec 中声明。
- 顶层结构:
{ data: array, meta?: object }
成功响应 Schema
{
"$ref": "#/components/schemas/PublicCatalogProductListResponse"
}
错误响应 Schema
{
"$ref": "#/components/schemas/PublicErrorResponse"
}
本页由已验证 public-only OpenAPI artifact 生成；未提供推测性请求示例。