Web API と RSS

APIという用語

Web API と RSS

API という用語について：
- apiは、ソフトウェア部品等を提供する側が利用者に提供する約束事のようなもの。
- どんな使い方をするとどんな機能を得ることができるか、を示している。
- これまでに見てきた中では、
  - JavaScript言語に組み込まれた（ネイティブの）関数、あるいは
  - ライブラリ（jQuery）に含まれる関数、
  などもその仕様がAPIとして公開されていて、
  関数名、引数（の数や型）戻り値、など、細かく指示されている。
  
  Web API
- Web APIも目的は同じだが、関数呼出ではなくネットワーク経由でのWebへのアクセスに基づく使い方なので、
  - このサイト（URL）に
  - どんなパラメータをつけてアクセスすれば
  - どんな結果をレスポンスとして返すか、
  といったことが指示されている。
広義の Web API（URLパラメータによる）
- 例： google サーチに
```
    http://www.google.co.jp/search? にパラメータ
        q=___
        tbm=isch
```
  URLパラメータ
  
  などを渡す
- URLパラメータは図のような文法でURLの末尾に埋め込まれる。
- これについての詳細は検索してみること
一般的に Web APIという用語は、プログラムやWebページの中で使用する前提のものを言う。

データ受け渡し
- このとき渡されるデータの形式としては、下図の２種類（XML,JSON のうちのいずれか）が使われることが多い。
XMLかJSON
いくつかの例
- 郵便番号検索API - zipcloud
- yahoo天気→RSSを出力できる
- google マップ
有料もののや、アプリケーション登録を行って使う必要のあるものもある。
RSSとは
- フィードの一種
  （最新の情報が常に表示される仕組み）
- フィードとして他に ATOM などがよく使われる
- RSSビューワを使って表示する
- ブログ・パーツとしても多数作られている

サーバーサイド

補足 C/S 間でのデータ授受

Webサイト/Webページとして静的コンテンツが表示させる時は、サーバ（機）上でWebサーバ（ソフトウェア）が動作するが、
動的コンテンツ（Web上でのアプリケーション）においては、サーバ上で（Webサーバソフトウェアが仲介した上で）サーバ側（サーバサイド）プログラムが動作する。
- サーバサイドプログラムは図のように（仲介の方式によって）別の名で呼ばれることもある。

httpのメソッド

HTTPを使った通信で、レスポンス本文（要求に対する応答）以外に、クライアントとサーバの間でデータのやりとりをする方法として、以下のようなものがある。
1. URLパラメータ（前述）：GETメソッド（リクエストはヘッダーのみ送信される）で重要
2. リクエストのBODY部: 送信されるデータ量が大きい時、POSTメソッドで活用される
3. ヘッダ：特に重要なものが Cookieと呼ばれるデータ。
Cookie

4 実習

ローカルHTMLページにペタペタ貼り付けてみよう

twitterのタイムライン
（使ってる人は試してみよう）
- twitterにログイン
- 設定 -> ウィジェットでここにくるだろう
- 新規作成 -> プロフィール
- 試しに自分のタイムラインのURLを入れてみて、
- 生成完了直前に、サイズを調整し、
- 提示されたコードをHTMLに貼る
- と、こんな感じ(実施例)
livedoorのお天気プラグイン
- 上記サイトにある、天気プラグインのコード、または
- 県を指定して生成したものを、HTMLに貼る
- と、こんな感じ(実施例)
RSSビューで、
- たとえばyahoo天気予報を貼ってみよう。
- リンク「提供RSS」(http://weather.yahoo.co.jp/weather/rss/)から、
- RSSへの適当なリンク（アドレスの末尾が …xml）をみつけ、
- そのアドレス（URL)をコピーし、
- RSSビューの「Feed URL」欄に貼り、
- 「Create Widget」
- ただし、昨年1/23から、アカウント登録しないとCreateできなくなった
- 代わりに、ブログパーツを貼ってもいい（ただしブラウザによって動作しないこともあるようだ）
- 実施例
Yahoo! JavaScriptマップAPI（アプリケーションIDが必要）
- このページの指示に従って、HTMLを作ってみる
- アプリケーションIDを取得して、（今日はこのステップは略）
- HTMLの当該部分を書き換える必要がある。
- 今日は、平岡が取得したID(今だけ見えてます)を使っておいて下さい.
- 実施例