Web API The Good Partsのまとめ Part1

初めに

仕事でヘッドレスCMSを利用する機会があり、APIについてより深く知る必要ができたので以下のWeb API The Good Parts読みます。

読む前の期待

• Web APIの設計方法
• Web APIを設計する上で注意する点
• Web APIを利用する上でセキュリティ上注意する点

メモ

Web APIとは

👌 HTTPプロトコルを利用してネットワーク越しに呼び出すAPI

APIとは…Application Programming Interfaceのことで、機能は分かっているけれど中身の実際の動作は詳しくわからない機能のカタマリを外部から呼び出すための仕様のこと

• サービスを提供しているのなら、APIも公開すべき
• APIを公開することで、サービスの新しい活用方法などが考えられサービス自体の価値を高める。
• また既に公開されているAPIを利用することでユーザー側がサービスを利用するハードルを下げることができる

Web APIは美しく設計しよう

• 良いAPIは
  • 使いやすい
  • 変更しやすい
  • 堅牢である
  • 恥ずかしくない

感想

そもそも最初の内はAPIが何なのかさっぱりでしたが、WebAPIがURIであることを理解してからは少しずつ親近感がわいてきたように思います。
またネットで簡単に利用できるAPIなどを実際に触ってみるのも理解を深めるのに良いなと思いました。

また、この本は読書中ですが、Webを支える技術という本を読んでおくとかなり理解度が違うなと思いました。(RESTの概念や、HTTPメソッドの利用目的や背景などが特に）