前后端分离中，如何维护庞大的API文档以及API测试？

Question

API文档大部分还是手写的比较详细，虽然也可以通过某种方式实现自动生成，但自动生成的文档可读性并不符合团队的标准，有些接口的参数是比较复杂的。

API测试的目的是什么？假设等待项目完结之后在开始编写API测试，是否合理？

Answer 1

第一个问题不好说，很多项目甚至没文档，但并不意味着代码难读好的单元测试代码应该在设计接口之后，写实现之前，代码都写完了再去写测试，很多时候都会只验证正确的结果，所有才有了一种实践 TDD 测试驱动开发