错误码说明

HTTP 状态码

状态码说明
200请求成功
400请求参数错误
404资源不存在
500服务器内部错误

业务错误码

业务接口响应中的 code 字段:

错误码说明
0成功
1失败(具体原因见 error 字段)

错误响应格式

HTTP 错误

{
  "error": "Not found"
}

业务错误

{
  "code": "1",
  "message": "sessionId 不能为空",
  "error": "invalid_session_id"
}

常见错误处理

sessionId 缺失

错误

{ "error": "sessionId is required" }

处理:所有接口都需要 sessionId 参数,App 扫码后需保存并传递。

记录不存在

错误

{ "error": "Not found" }

处理:删除记录前先检查记录是否存在,或忽略 404 错误。

文件上传失败

错误

{
  "code": "1",
  "message": "文件格式不支持",
  "error": "unsupported_format"
}

处理:仅支持 jpg/png/gif 格式,上传前校验文件类型。