> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取 AceDataCloud 平台文档详情

> Platform 集成指南 - Ace Data Cloud

通过文档 UUID 或 alias 获取单篇文档的完整内容和导航关系。已知 alias 时可以直接请求，无需先从列表筛选。

## 接口概览

| 项 | 内容 |
| - | - |
| 方法 | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/documents/{id_or_alias}` |
| 鉴权 | 公开；知道 UUID 或 alias 即可直接读取 |

## 参数

* `id_or_alias`：文档 UUID、当前 alias，或保留在 `redirect_from` 中的旧 alias。
* `lang`：可选语言提示；也可使用 `Accept-Language`。最终内容语言以响应 `content_locale` 为准。

```shell theme={null}
curl --get 'https://platform.acedata.cloud/api/v1/documents/platform-token' \
  --data-urlencode 'lang=zh-CN' \
  -H 'Accept: application/json'
```

## 响应说明

详情使用单个对象响应，当前包含：

* `id`、`alias`、`redirect_from`、`name`、`title`、`type`、`rank`、`tags`；
* `content`、`content_mode`、`content_locale`、`content_hash`；
* `parent`、`sibling` 和按 rank 排序的公开 `children` 摘要；
* `api` / `proxy` / `dataset` / `integration` 关联，以及 `agent`（存在时）。

响应没有 `breadcrumbs` 字段。构建面包屑时可从 `parent` 继续读取其详情，或使用已缓存的文档目录关系。

## 错误处理

* ID/alias 不存在或不符合当前站点可见性：`404`。`private` 只控制列表可见性，不阻止知道链接的人直接读取，不能作为保密边界。
* 当前路由使用无尾斜杠形式；不要依赖代理层自动补斜杠。

## 相关接口

* [获取文档列表](https://platform.acedata.cloud/documents/platform-document-list)
* [获取 API 详情](https://platform.acedata.cloud/documents/platform-api-detail)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.