2022-09-02|閱讀時間 ‧ 約 3 分鐘

玩轉C#之【WebAPI】

什麼是 WebAPI?

維基百科的解釋:
Web API是指網頁伺服器或網頁瀏覽器的應用程式介面。
書本上看到的解釋:
Web API 是指藉由 http 通訊協定,進行請求、運算、回應的 API,提供 JSON、XML 兩種傳輸格式,基本上透過「網路」交換資訊,皆為 Web API 的範疇。
解釋: 你想像有一個黑盒子,它會跟你說輸入一個input,而會得出什麼Output,而你要把這個Input傳遞給黑盒子是透過http的方式
真實模型:
實際上,我們會將傳遞給input的這個行為稱為發送一個Request,而黑盒子將Output的資料回傳回來的時候稱為Response

什麼是 HTTP?

全名是 HyperText Transfer Protocol,中文翻作「 超文本傳輸協定」。
HTTP 是一套網路傳輸協定,為全球資訊網的資料通訊的基礎。也就是說,網頁前端和後端在溝通時,就是透過 HTTP 協定進行。
重點: 一個Request傳遞的時候的格式
  • header:額外資訊
  • body:主要內容

HTTP Request Method 請求方法
在 HTTP 協定中,定義多種方法,來以不同方式操作指定的資源。
GET:取得訊息 POST:建立訊息 PUT:更新完整訊息 PATCH:更新部分訊息 DELETE:刪除訊息 OPTIONS:會回傳伺服器支援哪些方法 HEAD:只獲取回應的 header,但沒有body TRACE:回傳收到的請求內容 CONNECT:通常用在Proxy。

RESTful API

RESTful API 是一種Web API的開發風格,透過REST風格的引進,可以生產並且持續規劃健壯的API。
重點:
  • 使用一致性的操作介面 (Uniform Interface) 表達「資源」/api/file
  • 將動詞設計在 HTTP Verbs 中GET /api/file POST /api/file DELETE /api/file
  • 回應訊息時的狀態寫在 HTTP 狀態碼中
HTTP/1.1 201 Created
Content-Type: text/json; charset=UTF-8
{
message: "Hello World!"
}
白話文: 網址不會變,改變的只有Http Method
關於RESTful API之後會專門寫一篇文章跟大家講解

參考資料

本篇已同步發表至個人部落格 https://moushih.com/2022ithome02/ 鐵人賽文章: https://ithelp.ithome.com.tw/articles/10287225
分享至
成為作者繼續創作的動力吧!
© 2024 vocus All rights reserved.