如何把一个接口设计好？ | 京东云技术团队
如何设计一个接口？是在我们日常开发或者面试时经常问及的一个话题。 很多人觉得这不就是CRUD，能实现不就行了。单纯实现来说，并非难事，但要做到易用、易扩展、易维护并不是一件简单的事。这里并不强调一些个接口设计的原则或者设计方法，仅从如何设计一个好的接口出发，简单讨论。 1、命名规范 我们写代码，不仅仅是为了实现当前的功能，也要有利于后面的维护。所谓的维护，就是代码不仅仅是写给自己看的，也是给别人看的。所以接口定义要清晰易懂、命名规范。 除了接口、方法、出入参命名规范，也要注意代码规范问题。一开始接触到各种代码坏味道的小伙伴，大多都会觉得这些规范很多余、很烦人，但实际上，这些好的编码习惯是让大家都能按照基本规约开发，易于阅读易于维护的基础。 在接口定义时，也请注意接口功能的单一性。其实这也是微服务的一些思想，接口功能的单一职责、明确简单。比如登录接口，它做的事情就是校验账户名和密码相关；订单服务、积分服务、商品信息相关的接口都是划分开的。 2、参数校验 入参出参校验是每个程序员必备的基本素养。你设计的接口，必须先校验参数。比如入参是否允许为空、入参长度要求、入参是否在枚举值范围内等等。日...
