【Mockoon工具箱】根據查詢參數回應不同的內容(Query Params)

 

上一篇我們介紹了模擬API的工具箱「【Mockoon工具箱】awesome API mocking簡介」， 也示範如何模擬回傳資料， 但我們的API通常千變萬化， 尤其是會搭配不同的查詢條件進行資料的抓取，正好Mockoon也提供了Rules的一個功能， 透過規則的設定回應不同的資料內容。

情境描述

API入口: http://localhost/endpoint

- 當我們沒有進行任何查詢條件時就回傳「welcome」的訊息。
- 當我們想要取得地址資料時，就用「Type=addr」的參數並回傳「台北市」的訊息。

上述的情境僅示範如何根據不同條件進行不同回應， 更多的參數條件就留待各位自行實作囉！

設計情境

根據上述的情境描述之後， 我們就開始設計這樣的情境吧！

設計入口歡迎訊息回應內容

第一個Response不需要任何的Rules(規則)， 僅設計回傳的歡迎訊息。

設計查詢條件規則

我們先增加一個Response， 來設計規則與回應內容。

新增了「Response 2(200)」之後， 我們先假設這個回應是查詢地址， 也期望回應內容如下：

接著我們來設計一下規則， 設計為查詢的類型為地址時， 若匹配則回應上述訊息。

實測結果

首先我們在瀏覽器輸入「https://localhost/endpoint」由於沒有任何的查詢參數， 因此會回應我們的基礎回傳歡迎訊息。

接著我們試著帶入查詢參數來看看結果， 指定查詢類型為地址， Mockoon的規則就根據我們的設計回傳地址的回應內容。

結語

原來API模擬不只有靜態的回應而已， 還能夠具有一些基礎的判斷， 讓我們在開發產品功能之前能夠快速的搭建出API並與前端工程師相互討論， 共同制定一套標準API規則， 再各自實作業務邏輯， 達到分工合作的效果， 減少等待依賴的耗時過程。

總之在於快速、效率的時代， 我們需要的是簡單快速使用的功能， 能夠在最短期完成任務的工具都是好工具， 我們要學習的就是快速適應的能力， 就讓我們持續學習新工具快速適應變遷的環境吧！

-----------------------------------------------------------------------------

喜歡撰寫文章的你，不妨來了解一下：

Web3.0時代下為創作者、閱讀者打造的專屬共贏平台 - 為什麼要加入？

歡迎加入一起練習寫作，賺取知識，累積財富！

資源參考

- https://mockoon.com/docs/latest/route-responses/dynamic-rules/