API 网关设计 （Rest 风格）

个人学习 加备忘 。

什么样的接口，是让人头痛？
1. 没有接口文档 。
2. 出入参数风格不统一 。
3. 异常提示不友好。
4. 模型结构混乱，接口粗暴升级 。
5. 稳定性差，还找不到人。

如果你是一名架构师，在带领团队开发大量的API接口，如何在保证项目进度的情况下又保证质量呢？

1. 首先把组员召集起来，宣讲项目对各成员的意义，从心态上重视该项目。
2. 制定接口开发规范，不允许有不清晰的接口结构
3. 在执行上对接口进行严格审查，建立奖罚制度。
4. 建议有效的沟通反馈机制，比如每日开展晨会，项目日报，周报总结等。

只要严格遵守以上四点，一般的效率问题和质量问题都不会得到解决，项目会按时完成，项目奖金也会顺利下发，形式喜人

真正解决办法应该技术层面去思考，是对程序的把控，而不是去把控人。

人不可控的因素太多了。

演变过程

分析 API 网关的作用 ：

1. 去掉mvc 控制器，将http 请求直接无缝接入java服务接口（不通过，映射key 去获取value）。
2. 统一出入参格式。
3. 统一异常规范（避免所有错误提示都是一个系统异常）。
4. 自动检测服务接口规范。

API 除了做到以上几点，还要保证他的易用性，没有过多的配置。

/***********************************分布式架构演变*****************************************************************/

单体架构

单体架构适合创业项目，优缺点都在图中，随着用户量的上升，数据量的加大，单体架构的我们还可以继续分布式部署，但是分布式部署如果还是支撑不了我们的并发量的话，此时我们就要考虑分布式架构了。

分布式架构