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

# API 介绍

> Base URL、请求格式、分页和错误约定。

## Base URL

| 环境            | Base URL                                  |
| ------------- | ----------------------------------------- |
| Alforse Cloud | `https://api.alforse.com/api/v1`          |
| 企业自部署         | `https://api.your-company.example/api/v1` |

## 租户范围

每个租户令牌都包含 tenantId、roleCode 和 subjectScope。主体范围或负责人范围不匹配时，资源可能以 404 隐藏。

## 请求格式

* Content-Type: application/json
* DTO 校验会拒绝未知字段。
* 列表端点使用 page 和 pageSize，pageSize 最大为 200。

## 错误码

先根据 HTTP 状态码判断处理方式；如果响应包含 `error.code`，再做业务级处理。参见 [错误码](/zh-Hans/api-reference/errors)。