> ## 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 status first, then `error.code` when present. See [錯誤码](/zh-Hant/api-reference/errors).