版本迭代

在 API 接口设计的时候要考虑版本因素,如果每次版本迭代都在原接口上改动,小的改动还好,但是对大的改动,这将是致命的,接口中将会冗余大量判断语句,影响代码的可读性。

所以,做好版本控制是必须的,可以在接口 RUL 地址中增加版本参数,从而区分不同的接口地址,比如 /api/v1.0/*

上传文件接口设计

业务中很多地方需要提供上传文件的接口,比如保存用户信息,需要上传用户头像文件,可以设计一个公共的文件上传接口,先将用户头像文件以表单形式提交至服务器,服务器返回地址,将地址组合进其他用户信息数据中,一起以JSON 方式提交数据。

参考

转载 https://www.yuque.com/yinjianwei/yc65uq/uxmspf