いまどき「マッシュアップ」という言葉を使うこと自体ちょっぴり恥ずかしいのですが、外部APIを連携する際のお覚書き。
これまで外部APIの連携は、「php」と「Ajax」でやっていたのですが、「jsonp」の手軽さに驚愕しました。
jsonpはセキュリティ的に使用上要注意とよく聞きます。
そのため、jsonpを使用することを避けてきたわけですが・・・。
これがどうして。
なんで今まで使わなかったんだろうと後悔です。
前置きはこのくらいにして、早速サンプルファイルを紹介(そのままコピペで試せます)。
JSONPを実装しようとすると、コールバック関数、オブジェクトとかいう言葉をよく聞きますが、一旦考えずに形だけ把握します。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="ja" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<script type="text/javascript">
function data(param){
alert(param.ビートルズ.リズムギター);
alert(param["ローリング・ストーンズ"]["ギター"]);
}
</script>
<script type="text/javascript">
data({
"ビートルズ":{
"リズムギター":"ジョン・レノン",
"ベース":"ポール・マッカートニー",
"リードギター":"ジョージ・ハリスン",
"ドラムス":"リンゴ・スター"
},
"ローリング・ストーンズ":{
"ギター":"ブライアン・ジョーンズ",
"リードボーカル":"ミック・ジャガー",
"ギター":"キース・リチャーズ",
"ドラムス":"チャーリー・ワッツ"
}
});
</script>
</head>
<body>
<p>alertで「ビートルズのリズムギター」と「ローリング・ストーンズのギター」を表示します。</p>
</body>
</html>
ここで注目するポイントは、
function data(param){
alert(param.ビートルズ.リズムギター);
alert(param["ローリング・ストーンズ"]["ギター"]);
}
まず、data()という関数を用意する。
dataという関数名は、その後に続くdata({~})のdataという名と一致させる必要がある。
dataという名前である必要はなく、callback()という関数を用意し、その後に続くデータをcallback({~})としても問題ない。
続いて、data()関数にparam(名前はなんでもよい)という引数を入れる。
このparamにすべてのデータが入っていると想像すると分かりやすいかも。
さらに、データの呼び出し方。
param.ビートルズ.リズムギター
と.(ドット)つなぎで情報をたどる方法と
param["ローリング・ストーンズ"]["ギター"]
と配列のようにつなぐ方法がある。
ただ、データが日本語の場合、配列のようにつながないと思わぬエラーの原因になりかねないので注意が必要だ。
試しに
param.ローリング・ストーンズ.ギター
と書き直すとエラーになるのが分かる。原因は、データ内に「・」があるため。
次に、下記ソースを外部化(とりあえず、サンプルファイルと同じ階層にsample.jsというファイル名)します。
data({
"ビートルズ":{
"リズムギター":"ジョン・レノン",
"ベース":"ポール・マッカートニー",
"リードギター":"ジョージ・ハリスン",
"ドラムス":"リンゴ・スター"
},
"ローリング・ストーンズ":{
"ギター":"ブライアン・ジョーンズ",
"リードボーカル":"ミック・ジャガー",
"ギター":"キース・リチャーズ",
"ドラムス":"チャーリー・ワッツ"
}
});
外部化したあとのソースは下記。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="ja" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<script type="text/javascript">
function data(param){
alert(param.ビートルズ.リズムギター);
alert(param["ローリング・ストーンズ"]["ギター"]);
}
</script>
<script type="text/javascript" src="sample.js"></script>
</head>
<body>
<p>alertで「ビートルズのリズムギター」と「ローリング・ストーンズのギター」を表示します。</p>
</body>
</html>
実は、この「sample.js」にあたる部分を、JSONP形式で用意されたファイル名に置きなおすことで、JSONP形式で返ってくるデータ名を関数名に置き直すと、すでにマッシュアップの下準備が完了している。
FOOMOOのAPIを例にしてみよう。
※FOOMOOのAPIを利用するには、事前に登録が必要です。
http://webservice.recruit.co.jp/hotpepper/
![]()
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ja" lang="ja" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="Content-Language" content="ja" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Script-Type" content="text/javascript" />
<script type="text/javascript">
function callback(param){
alert(param.results.api_version);
alert(param.results.shop[0].name);
}
</script>
<script type="text/javascript" src="http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=1f6b15afdba1e98d&large_area=Z011&format=jsonp"></script>
</head>
<body>
<p>alertでapiのバージョンとデータ一件目の店名を表示します。</p>
</body>
</html>
http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=1f6b15afdba1e98d&large_area=Z011&format=jsonp
を直接たたくと分かるが、JSONP形式で返ってくるデータ名は「callback」である。そこで関数名を「callback」にし、呼び出したいデータを呼ぶ。
最後に、コールバック関数名の変更の仕方を紹介
実は提供側がサポートしているかによってしまうが、リクエストパラメータに試しに「callback=test」を追加して直打ちしてみる。
http://webservice.recruit.co.jp/hotpepper/gourmet/v1/?key=1f6b15afdba1e98d&large_area=Z011&format=jsonp&callback=test
JSONP形式で返ってくるデータ名が「test」に変わったのを確認できる。
つまりコールバック関数名が変わった。
この辺はAPIの提供側に依存するため、よしなに確認する。
この書籍の中で、ライティングのユーザビリティについて触れている項目があり、激しく共感する部分だったので、ここで備忘録としてピックアップする。 ・・・
この書籍は、I部 リサーチ、II部 デザイン、III部 インプリメンテーションと三部構成になっている。この記事では、その中から、I部 リサーチ、・・・
これを知ったときはマジか!と飛び跳ねた。あらためて思い返してみると、確かに公式チュートリアルでも触れていたことをうっすら思い出す。そしてそのときとやり方がなん・・・
試したことはまだないけど、Macで編集時と書き出し後で色味が変わって困ったときのために備忘録。 プロジェクト設定 > 「カラーマネジメント・・・
プロジェクト設定と環境設定について詳しく解説されている情報がなかなか見つからないので、要所要所で知り得た情報を更新していきます。 プロジェクト設定 ・・・
Clipyが超絶便利そうだったので、macOS Big Sur にインストール&再起動して使ってみた。ところが、command + c を複数の箇所で行い、c・・・
requestAnimationFrame をはじめて見たので調べていたら、setTimeout や setInterval は requestAnimati・・・
6年ぶりに読み返したが、今なおハッとさせられることが多く見つかる。 この本で忘れないようにしたい項目をピックアップするだけでも役に立ちそ・・・
この記事では、以前に読んだ際に付箋を付けていたが、その部分だけを備忘録としてピックアップするため、本の要約ではない。実際は、何倍も濃い内容で、練・・・
もう一回、全部読み返したいところだが、書籍がありすぎるので、当時付箋紙をつけていたところだけをピックアップ。書籍内ではより具体的な説明があるので・・・
これまでに扱ったことのないようなものを取り扱うときには、次のような問いを参考にすると何をしたらよいかが分かってくる。 どの部分が可動部で、どの部分が固定部か。・・・
以前に書いた「このサイトのリニューアル」で、リニューアル意思を示しつつも結局保留にして、先送りしてしまっていたけど、このあいだの週末(2013.3.29-30)・・・
エラーが起こっても大丈夫なシステムを作ると、みんなそれに頼るようになるので、信頼性を高くしておいたほうがよいだろう。 エラーの原因を理解し、その原因が最も少な・・・
こんな製品は使いたくない例1 教示がよくない。 システムの操作が可視的でない。 操作した結果が目に見えない。 こんな製品は使いたくない例2 デザイナーは良か・・・
いつもは直接アップロードしているので気にしていなかったが、WordPress管理画面のメニュー「メディア」からfavicon.icoをアップロードしようとした・・・
「デザインノート EXTRA good design company 水野学」から抜粋して自分なりの解釈を追加した過去メモ。 「iD」メイキング ・・・
新規コンテンツ「たびのと言ノ葉」公開 Webマガジン「たびのと」を夏に公開しましたが、たびのとのコンテンツの一つとして「たびのと言ノ葉(ことのば)」を新規で作・・・
外界の中の知識 人は環境を構造化して、思い出さなくてはならないものに関する多量の情報を手に入れることができるようにしている。 そのために、「ofの知識(事実につ・・・
もはや他ブラウザでも問題ないようにクロスブラザ対応だけでなく、スマートフォンやタブレット端末などマルチデバイスに対応できるようになっておかなければ、という時代に・・・
いろいろ調べると、疑似クラス「:placeholder」と「:placeholder-shown」というのにいきつく。 ちょっとハマってしまったので備忘録。ハマ・・・
「test」
「>ころころさん コメントありがとうございます! 確かに、APIドキュメント見ましたが、ライブに関する情報は今のところ取得できないようですね。 インスタライ・・・」
「SIGMAから超軽量で明るい単焦点レンズが2本発売になりましたので、リストにレンズ情報追加しました!」
「>名無しさん ご指摘、ありがとうございます! 記事冒頭の「まずはサンプル」のサンプルが動いていませんでしたので修正しました。」
「>前田さん コメントありがとうございます。 環境は分かりかねますが、修正したいファイルのパーミッションを604や644に変更すると書き込みできるようになります(・・・」
「アバターを取得する「get_avatar」についても追記しました!」
「「値をクリアする」を追加しました。チェックボックスやラジオボタンの値を何も選択していない状態に戻すときについて触れています。」
「>匿名さん コメントありがとうございます。 サンプルでは、beforeは何も処理していないので期待する表示にならない、で正解です。 クリックした後が、対応・・・」
「(匿名)さん コメントありがとうございます。何も設定変更していないのに、それまで使用できていたサーバーが突然使えなくなるのは辛いですよね、、。 ここで紹介したや・・・」
「コメントありがとうございます! そもそもできるかはわかりませんが、ソースを書き換える必要はあります。 下記記事などが参考になるかもしれません。 illustra・・・」
WEB制作マークアップJavaScriptJSONP Javascriptがちょっと分かってきたかも | シンプルシンプルデザイン