首頁 Web基礎系列

# [Web 基礎系列] 聽說你寫過聊天機器人？你真的知道 WebHook,RESTful API?

# Webhook Introduction

# 想像一下假設你現在的 Server 想要做即時更新

但你只會寫一般 Restful API 被動的去接收請求，但無法主動的更新所有 Client.

Webhook 就是在解決這類的問題，達到 Server 能夠主動推撥到另一個 Client
因這一特性 Webhook 也稱作反向 API

# RESTful API

你可能會寫 API，但你有照 RESTful 的風格進行 API 開發嗎？，往下來看看這些特點你是否有做到。

# HTTP Verbs

我們知道製作 API 除了要設置路由之外，請求方法也是一個要點，所謂的請求方法也就是標題所說的 HTTP Verbs

  • POST: 新增資源，也可以做一些特殊要求 C->Create
  • GET: 取得資源 -> Read
  • PUT: 更新資源 -> Update
  • PATCH: 更新部分資源內容 -> Update
  • DELETE: 刪除資源 ->Delete
  • HEAD: 取得 HTTP Header

其中 GET，HEAD 由於實際上都是讀取資源並不會去動到 Server Resource

# RESTful API 相關規範

由於 HTTP 是無狀態的通訊協定，一件事情不應該分成兩條 API 組成
參數樣式盡量應保持一致
HATEOAS (Hypermedia as the engine of application state) 應用程式狀態引擎超媒體

# URI Nouns

URI: Uniform Resource Identifier，統一資源標識符
URL: Uniform Resource Locator 統一資源定位符

URI = [Prefix] +API Endpoint

URI 設計原則

  • 一般資源用複數名詞
  • 唯一資源用單數名詞
  • 資源層級反映在 URI 上
  • Utility API 設計合理即可
  • URI 建議小寫可用 - _ 分隔但風格要統一

# HTTP Status Code

  • 1XX:Information
  • 2XX:Success
  • 3XX:Redirect
  • 4XX:Client Error
  • 5XX:Server Error

# HTTP Header

在我們發出 HTTP Request 的時候會夾帶一些資訊他會描述在請求的 Header 之中

常見的有

  • Accept 接受資源型態
  • Authorization 認證資訊

# HTTP Body

常見格式 JSON、XML