V5.2.3版本后轿腺,ApiPost開始支持“文檔歸檔”。
什么是文檔歸檔丛楚?
在ApiPost之前的版本里族壳,一直有一個很難受的問題困擾者我們和使用者:當(dāng)我們把文檔的分享鏈接分享出去之后,由于文檔和當(dāng)前操作的接口數(shù)據(jù)是實時一致的趣些,導(dǎo)致很多時候仿荆,后端人員一不小心的保存就會造成前端文檔的更改。
為了避免此情況的發(fā)生坏平,我們在上個版本(V5.2.1和5.2.2)做了一個嘗試:把接口保存和文檔保存分開拢操,接口保存不會保存文檔。但是造成的后果就是:明明我們的目錄有數(shù)據(jù)舶替,因為沒有點擊文檔保存令境,導(dǎo)致分享數(shù)據(jù)的文檔鏈接就是沒有數(shù)據(jù),或者顾瞪,每次我新建一個接口都需要重新保存接口并保存文檔舔庶,增加了用戶的操作成本。
于是陈醒,經(jīng)過我們團(tuán)隊的激烈探討惕橙,V5.2.3版本起,定下了這個方案:文檔歸檔機(jī)制钉跷。
所謂“文檔歸檔”是指弥鹦,此文檔一旦被歸檔,那么前端展示的文檔就是歸檔那個時刻的文檔快照尘应,不會隨著客戶端的臨時修改導(dǎo)致的接口保存而改變惶凝。未歸檔的情況下吼虎,文檔頁面仍是實時文檔犬钢。
怎么查看并管理已歸檔文檔?
通過點擊歸檔文檔管理查看并管理思灰,一旦取消歸檔后玷犹,文檔頁回到實時模式。
附:ApiPost簡介:
ApiPost是一個支持團(tuán)隊協(xié)作洒疚,并可直接生成文檔的API調(diào)試歹颓、管理工具坯屿。它支持模擬POST、GET巍扛、PUT等常見請求领跛,是后臺接口開發(fā)者或前端、接口測試人員不可多得的工具 撤奸。