前后端分离就是把业务逻辑和页面呈现分开了，
后端就是业务逻辑，
前端就是页面呈现，
必须合在一块才是一个完整的应用。
怎么合？
后端负责根据应用的功能点/业务逻辑编写API接口，API接口就是某个功能点/业务逻辑在后端的最终实现。
后端写了N多个接口提供给前端调用。那这些接口分别对应哪些功能点/业务逻辑？每个接口都需要什么参数？每个参数都是什么意思？哪些参数是必填的？哪些参数是可以不填的？每个接口能返回什么结果？返回结果的数据类型是什么？正确的情况下应该返回什么？错误的情况下应该返回什么？…
这些问题在开发过程中，如果后端人员一字不说、一言不发，前端人员就崩溃了，我是谁？我在哪？鬼知道这些都是什么…
所以才会有API文档，API文档就是用来回答上面的问题的，是一个规范的、明确的接口说明书，详细的描述了每个接口的作用、入参、出参、返回值等等，此接口文档就作为前后端开发中衔接彼此工作的桥梁，即是对前后端同学开发工作的规范、约束，也是对应用的功能/业务逻辑的规范、约束，最大程度减少人的错误和代码的错误。
