今の会社に入って5年目になるが、初めて新人を後輩に持った。
彼ら/彼女らと会話していて「API ってなんだ」という話になる。哲学だ。
API はプログラムが他のプログラムを利用する時、どのようにして呼び出すのかを定めたもの。ルールというか仕様書というか。ただ、文脈で意味が変わる言葉のようにも思える。
API という言葉にはすごく広義の API 、広義の API、狭義の API の三種類があると思っている。
すごく広義の API は以下の A～D 全てを指す。
広義の API は以下の A, Bを指す。
狭義の API は以下の Aのみを指す。
| 公開 | 非公開 | |
|---|---|---|
| ウェブ経由 | A | C |
| 直接呼出し | B | D |
Twitter とかが公開している、「これを使ってうちのサービスをもっと面白く使ってネ」という API がこれ。一定のルールはあるものの、これを利用して色々やっても原則としてルール違反にはならない。また、多少の変更はあるかもしれないが原則として変更されることがない API である。
プログラミング言語のドキュメントがあって公開されているパブリック関数やらパブリックメソッドやらの定義を指す。これも多少の変更はあるかもしれないが原則として変更されることがない。例えば Java の String#codePointCount の定義は Java 5 から Java 8 まで変わっていない。A. との違いは外部との通信を原則として伴わず、既に完成した別のサービスではなくちょっとした単独の機能を呼び出す、という点だろうか。
原則として使うべきでない API。サービスが利用している API ではあるが、公開されておらず、外部の開発者は利用が原則として許されない API。サービス内で使っているため、コロコロ変更されるだろうし、利用した際のサポートもない。また、利用することがサービス規約違反になったりするかもしれない。Pixiv の情報を自動取得とかしたい場合はこういうものを用いる。
原則として使うべきでない API。なにか特定のライブラリの一部分を無理やり使ったりするときに使う。前に私がやった例としては Google Closure Compiler のコンパイル部分を直接実行したことがあった。これは非公開 API であるため、バージョンアップで急に動かなくなったりしても文句は言えないのである。
なろう小説API が比較的気軽に試しやすいと思う。オススメ。例もちゃんと載っている。
ただいまコメントを受けつけておりません。