摘要:接口管理工具大致分為線上工具和自建工具。安裝其他工具上面講的,不管是線上工具還是自建工具,都是接口集成工具,主要是為了提供數據功能。類似網易云筆記印象筆記的筆記管理工具。
api 接口管理工具
現在,Web 應用的前后端分離事實上已經成為了大家都認可的一種開發方式,前后端分離之后,前端與后端都用接口(api)來溝通,這就需要我們做好 API 接口管理,所以,這次來聊聊 API 接口管理工具。
API 接口管理工具大致分為線上工具和自建工具。
1. 線上工具比較熱門的線上工具有:
eolinker
apizza:界面與 postman 比較像
easyapi
apiview
2. 自建工具企業一般都采用自建工具,自己維護一套 API 接口管理工具,比較熱門的有:
yapi:去哪兒出品,線上演示地址 http://yapi.demo.qunar.com
RAP / rap2-delos + rap2-dolores:阿里出品,線上演示地址 http://rap2.taobao.org/
easy-mock:線上演示地址 https://easy-mock.com/
swagger:國外比較熱門的接口管理工具
2.1 yapi環境需求:Node.js (>= v7.6) & MongoDB (>= v2.6) & Git
yapi UI 很漂亮,操作很流暢,安裝比較簡單,使用也比較簡單,不與其他第三方工具或語言綁定。
如果喜歡簡單、UI 友好的,推薦使用這個。
安裝:yapi#安裝
2.2 RAP / rap2-delos + rap2-dolores環境需求:Node.js (>= v8.9) & MySQL (>= v5.7) & Redis(>= v4.0)
rap 功能非常全,UI 不是很漂亮,安裝比較復雜,使用也比較復雜,數據生成使用 mock.js。
如果對功能完善、系統穩定、用 mock.js 生成數據有偏好的,推薦使用這個。
RAP 目前有兩個版本,第一個版本的 RAP 已經被官方廢棄了,建議用第二個版本。
RAP2 分成了兩個包:
rap2-delos:后端數據 API 服務器
rap2-dolores:前端靜態資源
RAP2 的安裝步驟要麻煩一些,rap2-delos 可以參考官方文檔 rap2-delos#部署、非官方rap2-delos部署文檔,rap2-dolores 可以參考官方文檔 rap2-dolores#deployment-部署。
2.3 easy-mock環境需求:Node.js (>= v8.9) & MongoDB (>= v3.4) & Redis(>= v4.0)
easy-mock UI 很漂亮,操作很流暢,安裝比較簡單,使用也比較簡單,數據生成使用 mock.js,并且支持導入 Swagger Docs API。
如果喜歡簡單、UI 友好的,并且喜歡用 mock.js 生成數據或者導入 Swagger Docs API 的,推薦使用這個。
安裝:easy-mock#quick-start
2.4 swaggerSwagger 其實并不是一個工具,而是一系列工具,或者說叫一個生態:
OpenAPI-Specification:基于 yaml 語法格式定義的一套開放 API 文檔規范
swagger-ui:UI 展示庫
swagger-codegen:根據 Swagger 定義的 RESTful API 自動生成 Swagger 文檔(for java)
swagger-core:java 核心庫
swagger-editor:可視化編輯器
ReDoc:生成格式優美的 UI 界面(第三方)
swagger-node:for node.js
go-swagger:for Go
如你所見,這個生態功能非常全,但使用非常復雜,入門坎比較高。
這套工具對后端非常有用,特別是 java 開發,能直接根據注釋自動生成相應的 API 規范文檔,然后直接根據這個 API 規范文檔自動生成 UI 可視化界面與數據 Mock 服務器,而不是我們手動創建。
安裝:swagger
3. 其他工具上面講的,不管是線上工具還是自建工具,都是接口集成工具,主要是為了提供數據 Mock 功能。
如果僅僅是為了以靜態文本的形式做展示用,可以試試下面的一些工具:
3.1 Git 倉庫 + Markdown把接口文檔多帶帶建一個項目,使用 Markdown 的格式來書寫。
了解 Markdown 語法。
3.2 leanote類似網易云筆記、印象筆記的筆記管理工具。
了解 leanote。
3.3 gollum基于 Git 的 wiki 系統。
了解 gollum。
3.4 wiki.js基于 Node.js 的 wiki 系統。
了解 wiki.js。
后續更多博客,查看 https://github.com/senntyou/blogs
作者:深予之 (@senntyou)
版權聲明:自由轉載-非商用-非衍生-保持署名(創意共享3.0許可證)
文章版權歸作者所有,未經允許請勿轉載,若此文章存在違規行為,您可以聯系管理員刪除。
轉載請注明本文地址:http://specialneedsforspecialkids.com/yun/73006.html
摘要:只需要填寫測試的參數值,點擊下方運行按鈕,即可發起一次接口請求,請求結果將會在下方顯示出來保存歷史在接口測試界面,在進行接口測試后點擊下方保存按鈕將會把本次測試數據接口,測試參數等信息保存下來。 《API管理平臺XXL-API》 一、簡介 1.1 概述 XXL-API是一個簡潔易用API管理平臺,提供API的管理、文檔、Mock和測試等功能。現已開放源代碼,開箱即用。 1.2 特性 ...
摘要:創建測試環境并導入到用例集操作步驟如下動態圖創建測試環境并導入到用例集動態圖說明第一個頁面為測試項目列表頁面。第三個頁面為前置用例集列表頁面。 本文內容: 測試腳本管理:講述如何在 EOLINKER 上設計測試項目目錄結構。 編寫測試腳本:講述如何在 EOLINKER 上編寫接口測試腳本。 測試腳本執行及報告:講述如何在 EOLINKER 上執行接口測試腳本,及如何查看和下載測試報告...
摘要:創建測試環境并導入到用例集操作步驟如下動態圖創建測試環境并導入到用例集動態圖說明第一個頁面為測試項目列表頁面。第三個頁面為前置用例集列表頁面。 本文內容: 測試腳本管理:講述如何在 EOLINKER 上設計測試項目目錄結構。 編寫測試腳本:講述如何在 EOLINKER 上編寫接口測試腳本。 測試腳本執行及報告:講述如何在 EOLINKER 上執行接口測試腳本,及如何查看和下載測試報告...
前言 今天發現了一個很niubility的東西__API Blueprint__,先給出官網https://apiblueprint.org/。下面是官網給出的介紹: API Blueprint. A powerful high-level API description language for web APIs. 這個可以干什么呢?按照API Blueprint的語法(類似markdown),...
摘要:接口管理工具大致分為線上工具和自建工具。安裝其他工具上面講的,不管是線上工具還是自建工具,都是接口集成工具,主要是為了提供數據功能。類似網易云筆記印象筆記的筆記管理工具。 api 接口管理工具 現在,Web 應用的前后端分離事實上已經成為了大家都認可的一種開發方式,前后端分離之后,前端與后端都用接口(api)來溝通,這就需要我們做好 API 接口管理,所以,這次來聊聊 API 接口管理...
閱讀 1625·2021-09-22 15:25
閱讀 1506·2021-09-07 10:06
閱讀 3183·2019-08-30 15:53
閱讀 1090·2019-08-29 13:12
閱讀 3373·2019-08-29 13:07
閱讀 725·2019-08-28 18:19
閱讀 2269·2019-08-27 10:57
閱讀 982·2019-08-26 13:29