# 文档目录（外部 API）

本目录是外部 API 文档的人类可读入口。  
外部契约单一事实来源为：

- `/openapi-full.yaml`（完整对外）
- `/openapi-idp-oauth2.yaml`（IdP 子集）
- `/openapi-upstream-idp.yaml`（上游子集）

---

## 文档导航

| 场景 | 网页 | Markdown |
|---|---|---|
| 外部应用接入统一认证（IdP） | `/docs/idp-oauth2-integration` | `idp-oauth2-integration.md` |
| 外部应用接入统一认证（IdP API） | `/docs/idp-oauth2-api` | `idp-oauth2-api.md` |
| 统一认证站接上游 OAuth（配置） | `/docs/upstream-idp-integration` | `upstream-idp-integration.md` |
| 统一认证站接上游 OAuth（API） | `/docs/upstream-idp-api` | `upstream-idp-api.md` |

---

## AI 阅读入口

- `/api-docs-ai.md`（自动生成，适合 LLM 快速读取）
- `/openapi-full.yaml`（适合工具导入与契约校验）