大龄程序员12年经验，他通常会用什么工具编写API文档？

本文共计3985个文字，预计阅读时间需要16分钟。

写代码，哪个程序员都不怕。写文档，哪个程序员都害怕！为什么？还不是因为API工具不好用，不便捷，同步烦恼，测试看不懂……最近按摩师调研了一些周边的开发团队，发现他们害怕的原因……

写代码，哪个程序员都不害怕。 写文档，哪个程序员都害怕！ 为什么？ 还不是因为 API 工具不好使，不便捷，同步麻烦，测试看不懂……

最近橡皮擦调研了身边一些开发团队，发现他们列举的工具中，都出现过同一款工具，Eolink。

今天这次我们深度 “盘” 一下 Eolink 这款免费 API 协作平台，围绕这一功能上，到底投入了多大的开发成本，给我们带来了多少惊喜！

本篇博客重点围绕这些产研需求展开。

当 API 代码更新之后，API 文档自动刷新；

API 协作工具通过脚本进行自动刷新/同步；

基于 API 文档智能生成请求代码和业务代码；

当然在正式开始对接 Eolink 前，咱需要先使用 Python Flask 框架在本地构建一个微型项目，用于写接口代码。

阅读完本篇博客，你不但可以编写公司标准的 Python API 文档，还顺便掌握了 Swagger 与 Eolink 的对接，一举多得，一文多获。

一、Eolink 准备工作，Python 快速搭建 Swagger

这次案例橡皮擦选用的 Web API 框架是 Flask，所以搭建 Swagger 需要用到 Flasgger 模块，如果你用 FastAPI，可以不用多走这一步，直接使用 FastAPI 原生 API 文档即可。