Top Highlights

• 厳密に言うと、APIは何らかのソフトウェアによって公開されるインターフェイスにすぎない。つまり、内部の 実装（そのAPIが使われたときにソフトウェアの内部で実際に呼び出されるコード）を抽象化したものにすぎない。
• パブリックとプライベートの分類は、APIが どのように 提供されるかではなく、 誰に対して 提供されるかによって決まる。
• コンシューマはすべて重要だが、最初に考慮すべきコンシューマは開発者である。
• つまり、そのAPIを公開しているソフトウェアの作成に関わっていない人が使うことになる。だからこそ、初めての人でもコードを問題なく記述できるようなAPIにするために、あらゆる手を尽くさなければならない。
• 開発者が何かを行うためにAPIを通じて プロバイダアプリケーション を利用する コンシューマアプリケーション を作るとき、開発者とコンシューマアプリケーションが知っているのはAPIだけである。 何かを行う 方法を知っている必要もなければ、プロバイダアプリケーション（厨房）がその何か（調理）を実際にどのように行うのかを知っている必要もない。ただし、実装を見えないように隠すだけでは不十分である。実装を隠すのは重要なことだが、APIを利用する人が本当に求めていることではない。