我們再次點開info這個接口,來詳細的給大家說明下如何去編輯一個接口

上圖中接口編輯頁面可以分為三個部分:接口的基本信息,接口快照,接口的參數信息。
### 基本信息:
**名稱:** 接口的名稱

這里表示接口的創建者創建時間,最后操作者和操作時間
**保存:** 點擊保存,該接口的數據會被保存下來
**運行:** 點擊運行,可以調試該接口的數據
**預覽:** 點擊預覽,會切換到文字版本的展示頁面
**路徑:** 這里可以填入接口的路徑地址,路徑不包含baseUrl,baseUrl請前往左邊全局標簽頁里面設置。例如http://abc.com/login, http://abc.com 是baseUrl,這里輸入/login即可,支持restful url形式,例如:/info/{name} 支持路徑參數的粘貼,系統會自動識別路徑和query參數
**方法:** 支持GET,POST,PUT,DELETE,PATCH五種http方法
**分組:** 接口所在的分組
**狀態:** 分為開發中,開發完成,已廢棄,具體使用會在Mock數據里面做詳細解釋。
**分享:** 這個鏈接可以分享給沒有注冊DOClever的用戶,他們通過這個鏈接打開的就是這個接口的預覽界面。
**簡介:** 就是關于這個接口的描述
### 快照
快照我們會在版本管理-接口快照里做詳解!
### 參數信息
對于很多接口,不同的入參會返回不同的出參,所以在DOClever里面,可以有多個入參出參的配對,每個配對可以稱為一個參數實例。

上圖中未命名就是一個參數實例,我們可以點擊右邊的加號來添加多個實例
**Param:** 當我們在路徑里面填寫含有restful形式的url時,比如:/user/info/{id},DOClever會自動解析路徑,并且提供對param參數的支持,如下圖

**Query:** 這里代表的含義類似于http://aaa.com/user?name=sx&pass=111 這個地址中的name=sx&pass=111這樣的參數,我們需要填入的是參數名稱,參數是否必選,備注,參考值。點擊未填值,彈出如下圖所示:

填入該參數的參考值和備注,點擊保存
**Header:** 這里的含義代表我們發送該請求的自定義http頭部
**Body:** 當我們切換http method到post,put或者patch的時候,會出現Body這個標簽頁,我們切換到這個標簽頁,如下圖:

這里分為兩種模式,一種是以鍵值對形式(key-value),還有一種是把數據直接傳給http body(raw),當Header里面的content-type為空或者為application/x-www-form-urlencoded,multipart/form-data的時候,DOClever會切換為key-value的形式,其他情況會切換為raw。
key-value:值得注意的是參數類型,可以有文本和文件兩種,當選擇文件的時候,DOClever會切換到multipart/form-data的方式發送數據。
raw:我們可以現在不同的數據類型,選擇不同的類型header里面的content-type也會發生相應的變化,當現在JSON的時候,會出現如下圖所示的界面:

JSON的具體操作會在出參里面做具體講解
**Inject:** 這一部分在注入里面做詳細講解
**Result:** 這里代表的是出參的數據模型,出參也分為兩種,JSON,RAW。
JSON:這里又分為Object和Array兩種類型,Object代表返回的是一個json對象,Array代表返回的是一個json數組,參數字段從左到右依次為名稱,類型,是否必有,備注,Mock或者參考值,刪除按鈕,新增按鈕,這里值得注意的是類型,在DOCLever里面,json的類型有六種:String,Number,Boolean,Array,Object,Mixed,前五種都好理解,最后一種Mixed代表的是任意類型,當我們的參數類型不定的時候,就可以用Mixed來代替。當參數的類型為Array或者Object的時候,我們可以為該字段添加子字段,拖動該字段,我們還可以改變字段的順序,或者父子關系。

RAW:如果返回的是其他類型的數據,就可以在RAW標簽頁里面填入相關的信息。
