1.7 KiB
1.7 KiB
前言
为了使Sycamore_whisper项目的后端更易于使用,在v1->v2时决定统一api返回格式:
{
"code":1000,
"data":{
"text1":"1",
"text2":"2",
"list":["1", "2"]
}
}
你可能已经注意到了新增的code字段,这样做的目的是为了更清晰地让前端判断操作状态,而不是单纯通过http状态码或字段(OK,Fail)来判断。
编写本文是为了方便开发或调用api时理解code的含义,统一code标准。
需要注意的是,code只是为了更清晰地定位后端报错,而不是为了替代http状态码,所以也请注意不要给每个请求都是用200 OK状态码。
正文
| Code | 含义 |
|---|---|
| 1000 | 正常。适用于大多数成功的GET请求的返回。 |
| 2000 | 失败。请求方式错误,例如缺少指定参数。 |
| 2001 | 失败。未初始化。不应该在成功初始化后继续使用该code。 |
| 2002 | 失败。数据不存在。 |
| 2003 | 失败。服务器内部错误。 |
| 2004 | 失败。试图请求不存在的资源或使用不存在的Identity。 |
| 404 | api端点不存在。 |