RESTful Web Clients 技術手冊筆記

於 2022年9月21日 (三) 22:35 由 Tankianting討論 | 貢獻 所做的修訂

這是書本的筆記或心得,相關資訊:

作者:Mike Amundsen

書號:ISBN 9789864766994

這似乎是講客戶端面對 RESTful API 的處理指南。

第1章 簡單的HTML和API

  • HTML -> API
  • TPS 任務程序系統,Web 應用程式的其中一種
  • Method of form
    • get(讀)
    • post(增)
    • input 的案例:
      • <input type="text" name="nickname" value="" required="true" pattern="[a-zA-Z0-9]+">
    • pattern接正規表達式。
    • HTML 不支援 put(改)和 delete(刪)。
    • 這種形式少臭蟲,但只使用 post 更新資料。缺點:使用者不確定post是否完整。
    • 有連結也有表單
    • 有限的使用者體驗
  • WebAPI
    • 發佈遠端程序呼叫(remote procedure call)端點(endpoint)。
    • 設計 TPS->Web API
    • Object、CRUD、
    • task/[GET] R
    • task/[POST] C.U.D
    • 回傳 json。
    • 使用 cUrl 傳遞
      curl -x POST[PUT/DELETE] -H "content-type: application/json" -d '{"title": "testing"}'
    • 純json響應
    • 關於 URL 和 CRUD 的 API 設計
    • 沒有連結和表單
    • API 伺服器相對簡單

第2章 JSON用戶端

主要處理

  • Object
    • 可以忽略不需要的物件類別和屬性,所以特定物件類別屬性列表可以正面枚舉。
    • 建議加 prompt:提示用法。
  • Address
    • 可製作 address list。
  • Action:修改、調整等。
  • 伺服器端 API 調整,要配合調整相關的欄位與程式碼。