服务目录

状态

生效中

更新

2026-08-11

适用范围

API Platform 公开目录

目录列出所有已发布的服务版本。无论服务由平台自营还是第三方提供，在目录里的形态完全一致。

列出服务

GET /v1/catalog/listings

返回 Listing 及其已发布版本的摘要，含稳定 serviceCode、显示名与每个版本的标价。serviceCode 继续用于精确调用，不代表目录里存在第二个 Service 商品层级。

旧 /v1/catalog/services/** 仅为兼容入口；新接入应使用本页的 Listing 路由。

查看某个服务

GET /v1/catalog/listings/{serviceCode}

查看精确版本

GET /v1/catalog/listings/{serviceCode}/versions/{version}
GET /v1/catalog/listings/{serviceCode}/versions/{version}/contract

后者返回该版本的请求与返回体 schema、内容摘要，以及是否附带产物契约。

版本必须精确，没有 latest

调用时必须写明具体版本，例如 v1。平台不提供 latest 之类的隐式别名。

这是有意的设计：已发布版本不可变、不可覆盖、不可复用版本号。你今天按 v1 调通的请求，明天仍然是同一份契约、同一个价格。服务方要改，只能发布 v2，不会在你不知情时改变 v1 的行为。

价格

目录里每个版本标注一个总价（gross），单位是积分。你看到的就是这次调用会消耗的全部积分，平台与服务提供方之间怎么分账不对调用方公开，也不影响你付出的数额。