JSONの受取 WebAPIを利用してJSON形式のデータを受け取り、ブラウザ上に表示する処理を作っている最中です。 その実装の中で、 「WebAPIを呼び出すのは基本ブラウザのJavaScript側？それともサーバー側のPHPとかでも呼んで良いの？」 という基本的な使い分けが分からず、Web開発者の方々のアドバイスを頂いて切り分けたのが昨日の記事。 やはりブラウザ上でWebAPIから取得したデータを表示するだけなら、ブラウザのJavaScript側で実装するのがスマートで良いそうです(^-^)v ただ特段、ユーザーにデータ表示をさせたりしない用途であればサーバー側で実装してもＯＫとのこと。 まぁ待っている人がユーザーじゃなくて自分（開発者）とかであれば、時間が掛かってもまぁ問題ないですからねぇ。 と、言う訳で昨日はWebAPIを呼び出してJSON形式で返してくれる物で、以前からデータが欲

各サービスのAPIの仕様なんて覚えてらんねぇ！という人は是非。 Blockspringとは Blockspringは、TwitterやFacebookなどのソーシャルメディアをはじめ、Amazon、Youtubeなど様々なサービスからのデータを、プログラマがAPIを直接触ることなく表データとして取得することができるサービスです。サービスごとに規格の異なるWebAPIを利用するには学習コストが結構かかるわけですが、Blockspringはそういったサービスとプログラマーの間に立ち、データ取得のインターフェイスを抽象化してくれます。 非常に沢山のサービスに対応しています。 「ちょこっとデータが欲しいだけなのに、サービス毎のWebAPIを勉強するのもう疲れた」 そんな時はBlockspringを利用してみてください。 インストール BlockspringはGoogle スプレッドシートとエクセル

WebAPIの仕様を記述する方法はいくつかあると思う。 普通に日本語で記述する JSON Hyper-Schema、WADL、RAML、Swaggerなどを使う 仕様書の代わりにプログラムを書く HTTPメッセージそのものを記述しておく でも、文法にばらつきがあったり、読みにくかったり、ツールのセットアップが面倒だったり、どれもイマイチな所があって、手軽な方法が欲しいと思っていた。 何気なくcurlコマンドのオプションを調べていたら、「もうこれでAPIドキュメント扱いにしちゃえばいいんじゃね？」と思えてきたのでメモしておく。 curlコマンドのおさらい curlコマンドはlibcurlの付属コマンドで、最近のUnix系OSなら大抵最初から入っていると思う。コマンドの詳細はmanを読んでいただければ。 cURL - How To Use （マニュアルページ日本語訳） curlコマンドのオプシ

幅広い開発者にGoによるコーディングを試してもらえるよう、前半はWindows環境＋Eclipseを前提とした開発環境の作り方と、Goアプリケーションのビルド方法について説明します。後半は、「Goji」を利用した簡易的なWebアプリケーションの作り方について説明しますが、Goの構文や書き方といった基礎的なことの説明は割愛します。もし、Goプログラミングの基本を学習したい場合は、Webブラウザを使ってGoのコードの入力や実行を試すことができる「A Tour of Go」を試してみてください。 本稿を通して、1人でも多くの方にGoで開発を行うメリットや楽しさを実感していただけると幸いです。 Goの利点 世の中に様々な実績あるプログラミング言語が存在する中で、改めてGoを採用することにどのような利点があるのでしょうか？ 私は次のような利点を感じています。 ビルドした結果が「環境依存のない単一の実

現在ではREST APIはとても一般的な話題です。ほとんどすべてのWebアプリケーションの一部分となっています。シンプルで一貫性があり実際的なインターフェースは必須です。これは皆さんのAPIを他の人が使うことをとても容易にします。皆さんにとってはRESTの実践が日常的に感じられるかもしれませんが、RESTをあまり尊重しない人々もよく見かけます。これがRESTについて投稿するきっかけでした。 この記事にはRESTfulなAPIを設計する時に考慮すべきベストプラクティスがあります。 注意 : ここでのベストプラクティスは、私が過去の経験に基づいて良いと考える事例です。もし違う考えをお持ちであれば、お気軽にメールをくだされば意見交換できると思います。 APIのバージョンを示す APIのバージョンは必須であるべきです。これがあると時間が経ってAPIが変わっても影響を受けません。その方法の1つはUR

この記事はPepabo Advent Calendar 2014の11日目の記事です。 前日は、tnmtさんのVagrantのshell provisionerでApacheのビルド済tarボールをOSバージョン毎に作る術でした。 はじめに 今回は、Web APIを作るときに考えることをまとめました。 本当は、社内向けに資料を作っていて、社内の勉強会とかで話せればいいか〜って考えていたんですが、アドベントカレンダーのネタが本当になくて困っていたのでこれを使います。 対象者 APIを作る時、と書いてますが、クライアント側の人にとっても知っておく必要があることなので、サーバ側の人・クライアント側の人両方が対象者です。 APIを作るときに考えること 「APIを作るとき」と言っても、色んな状況があります。 まずはそれを絞ります。 APIの種類 プライベートAPI アプリのAPIなど使う人が限定され

ヤフーは3月12日、通販サイト「Yahoo!ショッピング」に関する約50本のAPIを無料で公開したことを発表した。主に「プロフェッショナル出店」をしている法人ストアが対象となり、4月以降には個人ストアや、スマホで構築できる「ライト出店」を選んだ法人ストア向けにも公開する予定。 ヤフーは2013年10月にYahoo!ショッピングのストア出店料と売上手数料の無料化を発表。その後も、新たなストア構築ツールの公開やシステム改修など合計100以上の施策を実施してきたそうだ。今回、Yahoo!ショッピングのプラットフォームを開発者に開放することで、モールとしての利便性を高めるなどして、サービスをさらに活性化させていきたい考えだ。 開発者は、これまでYahoo!ショッピングが提供する専用ツールで行っていた、出品管理、在庫管理、ページデザインなどをAPI経由で管理、作成できるようになる。これらのAPIは「

ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式（＝コントローラ分割）でやってきて後悔したぼくが、（5年ぐらい前から）現在はどうやってAPIのバージョンを管理しているか？について紹介します。 基本原理としては、コピペが多発する根っこで分岐（＝コントローラ分割）じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。 一言でいうと、「パラメー