タグ

Web APIに関するluccafortのブックマーク (7)

  • Web APIにはJSONベースのフォーマットを使おう - Qiita

    { "response": { "id": 3342124, "message": "Hi!", "user": { "id": 3456, "name": "Taro Yamada", "image_url": "/images/taro.png" } } } など、どの構造がいいでしょうか? もっと違う構造も考えられます。 JSONはシンプルですが、構造に制約がなさすぎます。適切な設計を行うには適切な制約が必要です。 そこで、plain JSONに少し制約を加えたJSONベースのフォーマットを使うことをおすすめします。 もしあなたが、JSONレスポンスをどのようなフォーマットにするかをチームで議論したことがあるなら、JSON APIは『自転車置き場の議論』に対抗する武器となる。 共有された規約に従うことで、生産性が向上し、汎用的なツールを利用でき、アプリケーションという重要なものに集中

    Web APIにはJSONベースのフォーマットを使おう - Qiita
    luccafort
    luccafort 2015/12/07
    やりたいことは理解出来る、がそれはそれとしてこれでないと駄目!みたいな感じの強制されるのは嫌かなぁ。あくまでもフォーマットだから強制力はないのかもしれんけど。
  • RESTful Web API 開発をささえる Garage - クックパッド開発者ブログ

    技術部の小野(@taiki45)です。この記事では簡単なアプリケーション(ブログシステム)の実装を通して、クックパッドで作成・使用しているライブラリのGarage の紹介と Garage を使った RESTful Web API の開発をご紹介したいと思います。 Garage は RESTful Web API を開発するための、 Rails gemified plugins です。Rails プログラマは Garage を使って Rails を拡張することで素早く Web API を開発することができます。Garage は新しくアプリケーションを開発する場合にも、既存の Rails アプリケーションに組み込んで Web API を実装する場合でも使用できます。Garage はリソースのシリアライズやアクセスコントロールなど Web API の実装に必要な機能をカバーしています。 Ruby

    RESTful Web API 開発をささえる Garage - クックパッド開発者ブログ
    luccafort
    luccafort 2014/11/20
    「JSON API 開発の文脈ではデバッグ用のエラーレスポンスも JSON のほうが都合が良いです。」なるほど、確かにそういう側面は間違いなく存在するな。
  • Web API: The Good Parts

    Web APIの設計、開発、運用についての解説書。APIは設計次第で使いづらいものになってしまうだけでなく公開後の保守運用も難しくなってしまいます。そのためAPIを美しく設計することがとても重要です。書では「設計の美しいAPIは、使いやすい、変更しやすい、頑強である、恥ずかしくない」という考えのもと、APIをどのように設計し運用すればより効果的なのか、ありがちな罠や落とし穴を避けるにはどういう点に気をつけなければいけないのかを明らかにします。ターゲットは、URIにアクセスするとXMLやJSONなどのデータが返ってくるシンプルなタイプ――XML over HTTP方式やJSON over HTTP方式――のAPIです。読者は、Web API設計の考え方と手法を知ることができます。 はじめに 1章 Web APIとは何か 1.1 Web APIの重要性 1.1.1 APIでの利用を前提とした

    Web API: The Good Parts
  • Node.jsのWebフレームワーク「Sails」を使ってpub/subアプリを作ってみる

    Sailsとは Sailsは米国オースティンにあるBalderdash社のMike McNeilさんを中心として作成されているMVCフレームワークです。スタイルとしてはRailsに近い形を取りつつ、最近のWebアプリ開発に向けたいくつかの特徴を持っています。 主な特徴としては Web APIを簡単に作成し、公開できる リアルタイムWebなアプリケーションが簡単に作成できる Single Page SiteやMobileなどの多様なフロントエンドに対応できる といったようなものが挙げられます。 Web APIについてはJSONベースのRESTfulなAPIが簡単に作れるようになっています(Sails API blueprints)。特にAPIを作るという意識をせずとも、generatorによって単純なCRUDならすぐにAPIとして公開することができます。ルーティングについても、この手のフレー

    luccafort
    luccafort 2014/04/02
    多分Sails使うよりも先にもっと先進的かつ最新仕様に適合した新しいフレームワークが出てきてそっちがデファクトになってそう。
  • 入力フォームの迷宮。全角数字を強要するフォームを理解できません。 | SHINGO IRIE

    前々から思っていたんですが、住所を入力する際に全角で入れてくださいという指定をされていることがよくあります。これ、毎回イラッとします。 住所が全角だろうが半角だろうが、システム側で勝手に変換制御してくれよって思います。システム上、全角でないとマズイかどうかは利用者にとっては関係のないことです。 例えば、住所が福岡市天神1-2-3だった場合、福岡市天神1−2−3と入れなおす。そうすると−が全角ではありません。と出てきたり…。この「ー」もたくさん候補があるので、どれが全角だったっけ…と何度か試すこともあったり。まぁ、1丁目2番地3と書けばいいんですが。かたや、電話番号は半角で入れてくださいとか、まぎらわしい。 そのほか「住所の文字数がオーバーしています」って出てきたこともあります。マンション名が記入できませんでした。しょうがないので、マンション名をイニシャルで省略しました。小さなことかもしれま

    入力フォームの迷宮。全角数字を強要するフォームを理解できません。 | SHINGO IRIE
    luccafort
    luccafort 2013/08/23
    どの開発者に聞いてもこういうフォーム爆発しろ!としか聞いたことがないので多分お客さんの意見をごり押しされたんだろうな、でも死ねと心の中で念じております。南無南無。
  • WEB APIのURL設計のトレンドはこれだ!WEB APIのURL設計まとめ

    APIのURL設計をしようと思い、その前に有名サービスのAPIのURL設計がどうなっているのかについて調べました。 一覧を載せた後に、「多数派なURL設計」を書きたいと思います。

    WEB APIのURL設計のトレンドはこれだ!WEB APIのURL設計まとめ
    luccafort
    luccafort 2013/07/03
    面白いけど小盛感あるので続編希望。
  • Web APIの基本とAndroidアプリ開発の準備

    はじめに 第1回目の稿は、Web APIの説明と、開発を行うための準備として、開発環境のインストールについて解説します。 対象読者 Androidアプリケーションの開発を始めたい方で、JavaとEclipseの基的な知識がある方を対象とします。 Web APIとは 連載であつかう「Web API」とはどういうものかを、まず始めに説明しましょう。 Web APIとは、ひとことで言えば、インターネット(Web)を経由して、何らかの処理を行うための、手段や決めごと(API)のことです。APIとは、Application Program Interfaceの略で、直訳すると、あるプログラムを、他のアプリケーションから利用するためのインターフェース、という意味になります。 一般的なプログラムでは、関数やサブルーチンと呼ばれるひとかたまりの処理を作成し、それをプログラム内のほかの場所から呼び出す

    Web APIの基本とAndroidアプリ開発の準備
  • 1