接口服务正规化

一个好的后台接口，需要注意的细节：
1 接口名称：动词+名词 简洁明了，基本能说明接口的功能。
2 接口注释：功能+作者+时间+出入参数
3 接口参数：定义清晰、规范定义（驼峰）、简单明了，尽量直观能表示其含义。
4 接口逻辑：
（1）入参参数的非空判断
（2）入参参数格式校验（类型：正则校验、枚举校验、数据字典校验、大小写校验、业务数据校验等。）
（3）接口业务逻辑代码
数据库交互（主意单个事物、整个服务类型事物的关系）、第三方接口交互、内部接口交互等略
（4）出参，result（泛型：业务参数，根据业务诉求合理设计业务参数）、status（状态码）、msg（信息提示，场景覆盖全）、success(布尔类型，成功标识)。
5 注释：接口分层次注释，声明每个私有方法的作用，简洁明了。
6 日志：接口出入口日志标识、异常日志信息、可展示的业务数据日志等（日志级别遵照基本原则和项目组对日志级别的要求）。
7 接口参数格式、协议、权限等都遵照项目组的规定来处理。