47 lines
551 B
Markdown
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": ""
|
||
|
|
}
|
||
|
|
```
|