APIを学ぶのに必要な事

質問

• APIを学ぶ上での基礎を身につけるためには、参考書やスクールでの学習がおすすめです。
• APIを利用したシステムを作成する際は、PHPの知識だけでは限界がありますので、他のプログラミング言語やフレームワークを学ぶことも重要です。
• APIを利用する際は、ドキュメントの読み方やAPIキーの取得方法、リクエストとレスポンスの処理などについても学んでおくと良いでしょう。

回答No.3

noname#244856 · ベストアンサー

正直、プログラミングスクールは料金がかかる割に対価が少ないような印象を受けるので、個人的にはあまりおすすめできません。それよりはGoogleを主体的に利用して学習していく方法のほうが無料で済むのでありがたいと思います。

多分APIに対してとっかかりにくいのは、API以前にネットワーク通信技術の背景が分かっていないからだと思います。ヒントとなるように順を追って掲載していきますので、よかったら参考にしてください。

まず、「プロトコル」「OSI参照モデル」「TCP/IP」を順に検索してみてください。

【要点: 用語整理】
・プロトコルは通信のための取り決め
・OSI参照モデルはプロトコルを理論的に階層化したもの
・TCP/IPはOSI参照モデルを一部採用しながら現実に実装したもの

TCP/IPのWikipediaのページを開いてみてください。
http://ja.wikipedia.org/wiki/%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%8D%E3%83%83%E3%83%88%E3%83%BB%E3%83%97%E3%83%AD%E3%83%88%E3%82%B3%E3%83%AB%E3%83%BB%E3%82%B9%E3%82%A4%E3%83%BC%E3%83%88

1. リンク
この部分はハードウェア屋さんの仕事なので、プログラマが直接触れることは少ないです。

2. インターネット
IPの意味だけ把握していればOKです。単純に「インターネット上の住所」という程度で構いません。

3. トランスポート ※重要
通信相手のIPを指定して実際に通信を行う層です。「実際にどうやって通信しているか」を掘り下げる最下の層はここで構いません。これ以上深いところに掘り下げるとハードウェアが関連してくるので、こことこれより上の層を理解していれば十分です。「TCP」と「UDP」が非常によく使われます。UDPは音声通話など「多少欠損してもいいから速度第一」という目的、TCPは正確性を追求するときに使われます。大部分の通信はTCPで行われているのが現状です。

4. アプリケーション ※重要
TCPやUDPを使えば、相手にテキストデータ・画像データ・映像データなど、どんなデータでも送信することが可能です。しかし、「ここまではファイル名などの情報」「ここからは実際のデータ」といった線引きが為されている必要があるのは言うまでもないでしょう。それを行うのがこの層です。「HTTP」や「FTP」などが有名です。

実際にTCPを使っていく前に、1点補足しておきます。ルータなどのハードウェア機器に関して「ポート」などの名前を聞いたことはあると思いますが、これは内外を繋ぐ出入口のことを指します。出入り口はトランスポート層のプロトコルごとに65536個ずつ割り振られています。つまり、「TCPポートで0～65535」「UDPポートで0～65535」というように存在しているということです。実際に番号を指定しないと通信を行うことが出来ません。また、既に使用されているポートは別のアプリからは使うことが出来ません。

【要点: TCP通信の実現に必要なもの(UDP通信でも同様)】
・IPアドレス(またはホスト名)の指定
・ポート番号の指定

なお、よく使われるポートはアプリケーション層のプロトコルごとに慣用的に決められています。ポートの指定を省略したときはこれがデフォルトとして使われることが多いです。

HTTP → 80
HTTPS → 443

さて、実際にTCPを使ってみましょう。試しに以下のページを取得してみます。

A very simple webpage
http://csb.stanford.edu/class/public/pages/sykes_webdesign/05_simple.html

コンソールからtenletコマンドを用いれば、簡単にTCP通信を行うことが出来ます。

※ WindowsVista以降ではデフォルトでは使えないので注意してください
http://so-zou.jp/software/tech/network/tool/telnet/

1. 「telnet」でtelnetクライアントを起動。
2. 「open csb.stanford.edu 80」でTCP接続。
3. 「GET /class/public/pages/sykes_webdesign/05_simple.html HTTP/1.0」と入力して改行。
4. 「Host: csb.stanford.edu」と入力して改行。
5. 何も入力していない状態で改行。

すると、コンソールにダーッとHTMLソースが流れ込んでくると思います。でも、それより前に何やらメタ情報のようなものもついていますよね？これは「レスポンスヘッダー」と呼ばれるものです。逆にあなたが最初にステップ3,4,5で送信したものは「リクエストヘッダー」と呼ばれます。詳しくは以下のリンク先にまとめられているので是非読んでください。

HTTP入門
http://www.tohoho-web.com/ex/http.htm

Webブラウザは日頃何をやっているかというと、先ほどの通信を行い、「レスポンスヘッダー」の情報を裏で解釈しつつ、「レスポンスボディ」のHTMLをもとに画面にテキストや画像を表示しているだけのことです。

---------------------------------------------

～閑話休題～

PHPはさまざまなレベルでの通信に対応しています。

[TCPを直接叩く低レベル通信]

<?php
$fp = stream_socket_client('tcp://www.example.com:80');
fwrite($fp, implode("\r\n", [
　"GET / HTTP/1.0",
　"Host: example.com",
　"",
　""
]));
$resopnse = stream_get_contents($fp);

※ レスポンスヘッダが含まれます。ヘッダとボディを分割したいときは以下のコードを使ってください。

list($header, $body) = explode("\r\n\r\n", $response, 2);

※ fgetsでループする人もいますがstream_get_contentsで十分です。
※ 文字列として得たい場合はstream_get_contents、そのまま出力するときはfpassthruを使ってください。
※ stream_socket_clientの代わりにfsockopenを使うことも出来ます。

[HTTPを利用する高レベル通信 (file_get_contents編)]

<?php
$resopnse = file_get_contents('http://www.example.com:80/');

※ レスポンスヘッダは含まれません。その代わり、レスポンスヘッダの配列は $http_response_header としてその場に定義されます。
※ 文字列として得たい場合はfile_get_contents、そのまま出力するときはreadfileを使ってください。

[HTTPを利用する高レベル通信 (fopen編)]

<?php
$fp= fopen('http://www.example.com:80/', 'r');
$resopnse = stream_get_contents($fp);

※ レスポンスヘッダは含まれません。その代わり、レスポンスヘッダの配列は $http_response_header としてその場に定義されます。
※ 文字列として得たい場合はstream_get_contents、そのまま出力するときはfpassthruを使ってください。

[HTTPを利用する高レベル通信 (cURL編)]

<?php
$ch = curl_init();
curl_setopt_array($ch, [
　CURLOPT_URL => 'http://www.example.com:80/',
　CURLOPT_RETURNTRANSFER => true,
]);
$resopnse = curl_exec($ch);

※ レスポンスヘッダは含まれません。レスポンスヘッダを取得するにはちょっとした工夫が必要ですが、ここでは省略します。

---------------------------------------------

さて、ここまでちゃんと理解できていればAPIの理解ももはやすんなりと出来る状態だと思います。次の説明に行きたいのですが…残り文字数が少ないので回答を分けることにします。

お礼

ベストアンサーはNo.3とNo.4二つあるのですが、No.3のほうにしておきます！

ありがとうございました！