【知曉雲 API Gateway】API 樂隊指揮家，網關服務正式上線

時間 2020-05-16

標籤知曉 api gateway 樂隊指揮家網關服務正式上線欄目 CGI 简体版

原文原文鏈接

做者：知曉雲資深工程師 John Denghtml

隨着知曉雲小夥伴們業務的發展，對咱們服務的支持又有了新的要求，好比在對接第三方服務時，須要自定義數據結構等。爲此，通過 32 次的需求討論會以及工程師們的緊張開發後，知曉雲 API 網關誕生了。你能夠經過可視化界面配置 API ，點擊發布，便可完成一個對外服務的 API，再也無需等待構建/部署流程，大大節約了開發成本。

知曉雲 API 網關（API Gateway），是 API 發佈、管理、運維的全生命週期管理工具。讓開發者經過可視化界面配置並生成 API 提供給全平臺使用，省掉了繁瑣的服務開發及部署環節，五分鐘便可完成 API 定製開發。前端

使用 API 網關，還可讓運行在知曉雲上的應用數據得以更加靈活地提供給外部系統集成，無需再經過知曉雲的 OpenAPI 進行數據轉接，使得業務推動速度躍升一個等級。json

API 網關的使用場景

1.接收外部系統回調小程序

API 網關會將外部系統的回調內容傳遞至後端服務（雲函數），處理完成後，還能夠返回符合外部系統要求的內容。segmentfault

2.定製 API 接口，自定義返回內容後端

直接使用知曉數據表相關的 API 時，沒法對其返回內容進行自定義，更加沒法應對涉及多表數據合成爲一個對象返回的場景。api

使用 API 網關便可在雲函數中組裝好內容，經過其自定義返回內容的能力，將符合業務的數據格式返回到客戶端。安全

API 網關的執行流程

客戶端對 API 發起請求後，由網關進行有效性及路由匹配，將請求轉發到後端服務進行業務處理，再把後端服務的內容經過 API 網關返回客戶端。微信

PS：目先後端服務僅支持雲函數。數據結構

須要注意：

雲函數運行方式爲同步，超時時間爲 1.5 秒。

因爲雲函數須要告知 API 網關返回內容，所以雲函數必須返回如下數據結構，如不按照這結構返回，API 網關將會響應錯誤：

{
  "status_code": 200,
  "content-type": "text/plain",
  "content": "hello, world!"
}

status_code 爲響應請求的狀態碼。查看參考文檔
content 爲響應內容
content-type 爲響應內容的類型，支持：
- text/plain（純文本）
- text/html（HTML）
- application/json（JSON）
- application/xml（XML）