• 关于与后端接口对接,自己总结的几个原则


    最近几个月,与三位后台开发人员有过接口对接,每一次风格都不同,网上找到的也大多是关于RESTFUL风格的讨论,自己以及其他同事对RESTFUL的理解都不够到位,所以大多数工作中碰到的情况都不是RESTFUL风格,一般都是通过JSON自定义的格式。

    场景:主要是微信端网页开发,前端往往是先打开页面然后通过Ajax向后台发送请求返回JSON格式的数据。

    原则一:一个页面尽量只有一个拉取接口

    主要考虑的是尽量减少请求链接数,请求链接数越多,由于网络原因,出现异常的可能性越大。

    原则二:打破规则一,当请求需要缓存并且有需要及时更新的情况

    为了更好的打开速度,对于不经常变化的数据,往往需要做数据缓存以及请求缓存。但有些信息,比如预约时间,又需要做到及时,则应该分多个请求。

    原则三:如果返回数据中某个字段的数据没有,返回该字段比不返回该字段要好。

    JSON格式的好处在于灵活性,但没有校验机制。所以定义协议时规定了有哪些字段,最好这些字段都返回。我的意思是比如返回一个列表,大多数场景是返回一个数组,但如果没有数据,返回一个空数组比不返回该字段要好。当然前端也有必要做自己的容错考虑。

    其他:

    1.比较常见的返回数据的格式,经验有限,也不清楚这是不是最优的。

    {
        status: "",
        message: "",
        data: {
    
        }
    }
    

    2.这里有一篇关于HTTP API设计指南,感觉挺好的,但自己实际应用的不多。

    3.上面只是我个人的几点总结,如果有不对的地方请大家提出意见,如果网上或者其他书籍有相关的书籍,也希望大家积极分享,谢谢。

  • 相关阅读:
    js实现金额千分位显示
    iview中select组件使用总结
    在VUE中使用QRCode.js
    vue echart使用总结
    Iview Table组件中各种组件扩展
    前端架构模式Mvc和Mvvm
    express 中间件
    http与https的区别
    前后端分离与不分离的区别,两者的优势
    TCP三次握手、四次挥手
  • 原文地址:https://www.cnblogs.com/yangqionggo/p/5093067.html
Copyright © 2020-2023  润新知