本小節(jié)我們將學(xué)習(xí)如何定義后端的接口。

    開發(fā)之前，我們得分析后端需要提供哪些接口。

    我們可以根據(jù)需求文檔來進(jìn)行分析。

    第一個(gè)功能是用戶自動(dòng)登錄，那么我們后端需要提供一個(gè)接口實(shí)現(xiàn)用戶的靜默注冊(cè)，什么是靜默注冊(cè)？我們將在后面的章節(jié)詳細(xì)講解。

    第二個(gè)功能是展示搜索熱詞，那么我們后端需要提供一個(gè)接口能夠獲取系統(tǒng)中的所有熱詞。

    第三個(gè)功能是搜索某個(gè)詞的近義詞，那么我們后端需要提供一個(gè)接口返回某個(gè)詞的所有近義詞。

    第四個(gè)功能是對(duì)搜索結(jié)果點(diǎn)贊，那么我們后端需要提供一個(gè)接口可以增加某對(duì)近義詞的相關(guān)強(qiáng)度。

    第五個(gè)功能是聯(lián)系與反饋，那么我們后端需要提供一個(gè)接口可以接收并保存用戶的反饋信息。

    第六個(gè)功能是給用戶發(fā)送微信通知，那么我們后端需要提供一個(gè)接口給前端獲取訂閱消息模板的ID。

    第七個(gè)功能是管理員可以查看所有反饋，那么我們后端需要提供一個(gè)接口能夠展示用戶提交過的所有反饋。

    第八個(gè)功能是管理員可以刪除反饋，那么我們后端需要提供一個(gè)接口用來刪除指定的一個(gè)反饋。

    到此，我們已經(jīng)明確了后端需要提供哪些接口，但接口的詳細(xì)定義，我們將在后面的章節(jié)進(jìn)行詳細(xì)講解。

    為了方便前端調(diào)用和接口管理，我們必須提前定義好所有接口的返回值格式，無論接口處理的結(jié)果是什么，返回給前端的接口都必須是統(tǒng)一的。

    我們規(guī)定，接口的返回結(jié)果格式如下，返回的是一個(gè)json對(duì)象，里面有三個(gè)字段：

    第一個(gè)字段是errCode，代表的是錯(cuò)誤碼，0表示調(diào)用成功，其它數(shù)字代表失敗，每個(gè)數(shù)字代表什么含義，同學(xué)們可以根據(jù)自己的情況進(jìn)行定義。

    第二個(gè)字段是errMsg，代表的是錯(cuò)誤信息，用來對(duì)錯(cuò)誤碼的文字解釋，要不前端開發(fā)者只看到錯(cuò)誤碼，就會(huì)很迷惑。

    第三個(gè)字段是data，咱們將其它數(shù)據(jù)都放到這個(gè)里面。