获取 AceDataCloud 平台服务下的 API 列表

通过服务 ID 获取该服务下挂载的全部 API 端点信息（路径、定价、阶段、关联文档等）。与获取 AceDataCloud 平台 API 列表的区别：本接口只返回指定一个服务下的 API，前者会跨服务返回全部 API。

适用场景：服务详情页右侧的「该服务包含的接口」面板、Agent 工具能力枚举、文档站点导航生成等。

ℹ️ 本接口属于 AceDataCloud 平台管理 API，统一前缀 https://platform.acedata.cloud/api/v1/。完整接口索引见获取 AceDataCloud 平台文档列表。

接口概览

项	内容
方法	GET
URL	https://platform.acedata.cloud/api/v1/services/{service_id}/apis/
鉴权	❌ 公开

鉴权说明

本接口完全公开，无需账户令牌或登录态。

路径参数

参数	类型	必填	说明
service_id	UUID	✅	服务 ID。注意：必须是 UUID 格式，不支持 alias——这是历史遗留

⚠️ 这里和服务详情接口不一样：详情接口同时支持 UUID 和 alias，本接口只支持 UUID。如果你只有 alias，先调一次详情接口拿到 UUID 再用。

查询参数

参数	类型	必填	默认	说明
limit	integer	否	10	每页条数，最大 100
offset	integer	否	0	偏移
stage	string	否	—	按阶段过滤：Alpha/Beta/Stable/Deprecated
ordering	string	否	rank	排序字段，前缀 - 倒序

请求示例

cURL

curl 'https://platform.acedata.cloud/api/v1/services/8efa1d83-9b75-4562-b44a-af95ce563d05/apis/' \
  -H 'accept: application/json'

# 只看稳定版接口
curl 'https://platform.acedata.cloud/api/v1/services/8efa1d83-9b75-4562-b44a-af95ce563d05/apis/?stage=Stable' \
  -H 'accept: application/json'

Python

import requests

service_id = "8efa1d83-9b75-4562-b44a-af95ce563d05"
resp = requests.get(
    f"https://platform.acedata.cloud/api/v1/services/{service_id}/apis/",
    headers={"accept": "application/json"},
    params={"limit": 50},
    timeout=10,
)
data = resp.json()
print(f"该服务下共有 {data['count']} 个 API")
for api in data["items"]:
    print(f"  [{api['stage']:>10}] {api['title']:30s} {api['path']}")

Node.js

const serviceId = '8efa1d83-9b75-4562-b44a-af95ce563d05'
const r = await fetch(`https://platform.acedata.cloud/api/v1/services/${serviceId}/apis/`)
const { count, items } = await r.json()
console.log(`API 数: ${count}`)
items.forEach((api) => console.log(`${api.title} -> ${api.path}`))

响应示例（HTTP 200）

{
  "count": 7,
  "items": [
    {
      "id": "e4fbc3b6-4f44-48fb-a049-40f5c27c7cd3",
      "document_id": "20945baf-b263-457b-be5f-0332c2180a57",
      "service_id": "8efa1d83-9b75-4562-b44a-af95ce563d05",
      "name": "Face Analyze API",
      "title": "五官定位 API",
      "path": "/face/analyze",
      "path2": null,
      "introduction": "该API可用于对请求图片进行五官定位（也称人脸关键点定位），计算构成人脸轮廓的 90 个点。",
      "cost": [
        { "conditions": { "==": [1, 1] }, "consumption": 0.0025 }
      ],
      "stage": "Stable",
      "rank": 10,
      "tags": [],
      "metadata": null,
      "created_at": "2024-08-06T03:20:03.105765Z",
      "updated_at": "2026-04-26T16:16:56.579972Z"
    }
  ]
}

响应字段说明

字段	类型	说明
count	integer	符合条件的 API 总数
items	array	API 列表
id	UUID	API 唯一标识
document_id	UUID	关联的开发者文档 ID（可用于跳转获取 AceDataCloud 平台文档详情）
service_id	UUID	所属服务 ID（与路径参数相同）
name	string	API 英文名
title	string	API 显示标题（已本地化）
path	string	API 调用路径，业务接口前缀是 https://api.acedata.cloud，例如 /face/analyze 完整 URL 为 https://api.acedata.cloud/face/analyze
path2	string	备用路径，可能为 null
introduction	string	一段话简介
cost	array	定价规则（JsonLogic 格式）。conditions 匹配请求参数，匹配成功后用 consumption 计费
stage	string	生命周期阶段：Alpha、Beta、Stable、Deprecated
rank	integer	排序权重
tags	array	标签
metadata	object	扩展元数据
created_at	string	创建时间
updated_at	string	最近更新时间

ℹ️ 本接口不返回 definition（OpenAPI Schema）字段——schema 体量大且很少需要。要看 schema 请调用获取 AceDataCloud 平台 API 详情。

错误处理

HTTP	code	含义
400	invalid	service_id 不是合法 UUID 格式
404	not_found	服务不存在或已下线

实用提示

• 看到 stage=Deprecated 的 API 请勿在新项目使用，会在未来 6 个月内移除。
• 多 path 服务：少数服务（如 ChatDoc）有多套接口路径，本接口会返回多条记录。
• 自动生成 SDK：常见做法是先调 services/?type=Api，再对每个服务调本接口拿到 api_ids，最后调 /apis/{id} 拿 OpenAPI Schema 用 openapi-generator 生成客户端代码。

相关接口

• 获取 AceDataCloud 平台服务详情
• 获取 AceDataCloud 平台 API 详情 — 含 OpenAPI 3.0 Schema
• 获取 AceDataCloud 平台 API 调用统计 — 每个 API 的调用次数
• 获取 AceDataCloud 平台服务下的 Proxy 列表