# 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；一期未开放写操作。