go17/book/response/README.md
2024-11-23 10:55:52 +08:00

47 lines
551 B
Markdown

# api 接口响应
接口要区分 成功/失败
## 经典
成功和响应 使用一套机制
```json
{
"code": 0,
"data": <Book>,
"message": ""
}
```
成功:
```json
{
"code": 0,
"data": any,
}
```
失败
```json
{
"code": 10000,
"message": ""
}
```
## 根据贴合HTTP协议语义
通过 HTTP Code来定义 API接口返回是否成功
200
成功: 直接返回业务数据,不是再包装一层
```json
<Book>
```
失败之间返回失败信息, 400/401/403/500
```json
{
"code": 10000,
"message": ""
}
```