甚麼是 RESTAPI ?

內容說明

此文章講述於 RESTAPI 的大概使用方法與使用時機,並沒有詳細解釋,詳細解釋還需讀閱他人優秀文章

甚麼是 API?

就是別人把資料給你,你再把那些資料處理成資訊後再給別人,然後是透過 url 來進行交換的入口

API Method

  • POST:新增
  • GET:讀取
  • PUT:修改(修改整份文件)
  • PATCH:修改(修改其中幾個欄位)
  • DELETE:刪除

API 回傳資料

狀態 英文 中文 說明
200 OK 完成 通常在 get 時使用
201 Created 資源新增成功 通常在 post 時使用
202 Accepted 請求接受,但在處理中 有可能會失敗
204 No Content 請求成功,但沒有返回內容 通常用在刪除或修改
400 Bad Request 錯誤請求 通常有欄位未填寫或填寫錯誤
401 Unauthorized 使用者沒有進行驗證
403 Forbidden 使用者已經登入,但沒有權限操作
410 Gone 資源已經過期
500 Internal Server Error 伺服器端錯誤
502 Bad Gateway 伺服器某個服務沒有被正確執行
503 Service Unavailable 伺服器臨時維護或即將死亡,暫時無法處理請求
504 Gateway Timeout 伺服器上服務回應

觀念釐清:

POST 跟 GET 主要差在哪裡呢?

根據我的經驗(對不起我經驗連一年都沒有滿 QQ),我盡可能來進行解釋。

GET

  • 比較像是明信片,只能傳送簡單資訊。
  • 通常會將你傳送的資訊放在 url 之後。
  • 沒有 body,畢竟明信片也沒有 Body XD。
  • 如果有壞蛋想要看你寫甚麼,只要抓到你傳送的 url 就好,安全性較低。

    POST

  • 比較像是信封,可以傳送複雜資訊。
  • 通常是將你 post 的資訊放入 body 內。
  • 比起 get 有保障些,你傳送的資訊較沒有那麼容易就能被他人得知。

參考連結:

網頁Get 與 Post 差異 (科普壹點通)

心得

API 其實蠻好用,只是有點偏複雜。還需要多加磨練,我也要能夠讓自己變得更優秀,也謝謝各位前輩的努力。
也謝謝 台灣STEAM基礎教育聯盟給予我機會使我成長,對不起我有時候速度拖太慢。

  • 版權聲明: 本部落格所有文章除有特別聲明外,均採用 Apache License 2.0 許可協議。轉載請註明出處!
  • © 2020-2024 John Doe
  • Powered by Hexo Theme Ayer
  • PV: UV: