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