如何实现相亲交友源码 API 接口的统一格式返回?

前后端接口交互

我们都知道,相亲交友源码前端通常会通过后台提供的接口来获取数据来完成前端页面的渲染,所以在相亲交友源码开发时,要做好API接口的设计,以实现更好的效果。

相亲交友源码 API 接口返回值约定

返回值规范

  • 设置返回的 HTTP 响应状态码;
  • 相亲交友源码发生错误时,需设置 Response Body 的错误码和描述信息;

正确返回

HTTP 响应状态码,设置成 200,Response Body 结构为返回的数据结构。

错误返回

HTTP 响应状态码,不要设置成 200!需遵循 RFC 标准。

// Failure 错误时返回结构
type Failure struct {
    Code    int    `json:"code"`    // 业务码
    Message string `json:"message"` // 描述信息
}

统一定义错误码

错误码规范

  • 统一在相亲交友源码一个文件中定义错误码;
  • 错误码长度为 5 位;

第 1 位表示错误是哪种级别?例如:1 为相亲交友源码系统级错误,2 为相亲交友源码业务模块错误,可标记 9 种错误级别。

第 2 位和第 3 位表示错误是哪个模块?例如:01 为相亲交友源码用户模块,02 为订单模块,可标记 99 个模块。

第 4 位和第 5 为表示具体是什么错误?例如:01 为手机号不合法,02 为验证码输入错误,可标记 99 个错误。

Controller 层如何用?

正确返回

res := new(createResponse)
res.Id = 1
ctx.Payload(res)

错误返回

c.AbortWithError(errno.NewError(
    http.StatusBadRequest,
    code.AdminCreateError,
    code.Text(code.AdminCreateError)).WithErr(err),
)

return 

总结

以上便是“如何实现相亲交友源码 API 接口的统一格式返回?”的全部内容,其实还有很多的优化空间,希望能给搭建开发相亲交友源码提供帮助。

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值