swagger 是什麼 ?

一個讓你的後端API接口可以更視覺化被呈現的工具

官網：https://swagger.io/

1. 以符合 Open API 規範的方式撰寫API文件

2.撰寫語言為 YAML or JSON

Open API ?

WHY Swagger ?

在團隊開發中，一個好的API文檔可以減少很多交流成本，也可以使一個新人快速上手業務。

1. API文檔撰寫 — Swagger Editor

2. API文檔的顯示 — Swagger UI

3. 生成Mock(server端)服務 — Swagger Editor

4. 生成api client library — Swagger Editor

swagger-editor

線上版 ＆ 離線版

線上版：https://editor.swagger.io/

離線版

Mock server

 api client library

swagger-ui