ak
263b98b218
Captures the current working tree after theme slots, ArticleAccess, and the payment / paid-content plugins so subsequent work has a reviewable git history.
22 lines
777 B
Markdown
22 lines
777 B
Markdown
# API 文档
|
||
|
||
- **OpenAPI 3**：[`openapi.yaml`](./openapi.yaml)
|
||
- **实现**：`routes/api.php` → `/api/v1/*`
|
||
- **阶段**：一期以**只读内容接口**为主，供小程序/H5/其他端拉取文章、分类、标签与站点信息
|
||
|
||
## 快速试
|
||
|
||
```bash
|
||
curl -s http://larablog.test/api/v1/meta | jq
|
||
curl -s http://larablog.test/api/v1/articles | jq
|
||
curl -s http://larablog.test/api/v1/articles/1 | jq
|
||
```
|
||
|
||
## Swagger UI
|
||
仓库不强制绑定某一 UI 实现。可任选：
|
||
1. 把 `openapi.yaml` 导入 [Swagger Editor](https://editor.swagger.io/)
|
||
2. 自建静态页引用 swagger-ui（二期可加 `l5-swagger` / `scramble`）
|
||
|
||
## 鉴权（规划）
|
||
写接口（发评论、会员、支付回调）将走 Bearer Token / 小程序 session；一期未开放写操作。
|