docs: add comprehensive client API reference

wiki/api/16-fts-rest.md

@@ -0,0 +1,33 @@
+# FTS REST API
+
+文件上传与文件服务配置。基础路径：`/rest/fts`。
+
+## 路由
+
+| 方法 | 路径 | 鉴权 | 请求 | 说明 |
+|---|---|---|---|---|
+| GET | `/rest/fts/ping` | 否 | 无 | 健康检查，返回 Pong |
+| GET | `/rest/fts/config` | 否 | 无 | 获取上传字段、大小和扩展名限制 |
+| POST | `/rest/fts/uploader` | Bearer Token | `multipart/form-data` | 上传文件到 local 或 MinIO |
+
+## 上传文件
+
+```http
+POST /rest/fts/uploader
+Authorization: Bearer <token>
+Content-Type: multipart/form-data
+```
+
+| 表单字段 | 类型 | 必填 | 说明 |
+|---|---|---:|---|
+| `provider` | string | 是 | `local` 或 `minio`，服务端转为小写 |
+| `bucket` | string | 是 | 存储桶或本地目录分类，服务端转为小写 |
+| `file` | file | 是 | 默认字段名；实际由配置 `Fts.FtsConfig.InputKey` 决定 |
+
+服务端校验文件大小和扩展名，计算 SHA-256，并保存文件记录。默认开发配置最大 5 GiB，允许的扩展名见 `/rest/fts/config`。
+
+成功数据为文件记录，常用字段：`identity`、`name`、`ext`、`size`、`hash`、`status` 以及最终访问地址。响应使用项目统一结构：
+
+```json
+{"code":0,"message":"success","data":{}}
+```