最後更新：
Click to expand / collapse
為了使開發人員方便，API必須易於理解，可測試且有據可查。我們連接和配置Swagger UI、Postman和Insomnia-三種最受歡迎的工具,可讓您快速測試API,了解查詢結構,並簡化內部團隊和外部合作夥伴的集成過程。
為什麼需要這些工具
| 工具 | 指定 |
|---|---|
| Swagger UI | BOM OpenAPI在線文檔的自動生成 |
| Postman | 手動和自動測試查詢、集合、腳本 |
| Insomnia | 方便調試,處理交流、令牌、GraphQL、REST和gRPC |
我們實現的機會
從代碼生成OpenAPI （Swagger）規格
在瀏覽器中直接進行交互式API測試（Swagger UI）
在Postman/Insomnia中導入收藏品，其中包含所有endpoint的示例
與OAuth2、JWT、API密鑰一起使用工具
將測試和文檔與CI/CD pipline同步
為外部合作夥伴發布館藏
對團隊和客戶的好處
快速登陸新開發人員
加快外部團隊的集成
基於API結構的單一真相來源
在任何階段簡化測試和調試
減少合作夥伴提出的問題和集成錯誤
在哪裏，特別重要
開源API或SDK平臺
內部微服務,經常更改
API第一產品和B2B服務
任何具有高開發速度和團隊變更的項目