Rails5 apiモード + JSONAPI ResourcesでAPIサーバを作る - Smoky God Express
jsonapi-resourcesはこちら cerebris/jsonapi-resources: A resource-focused Rails library for developing JSON API compliant servers. 下準備 インストールまで いつものなのでサクサクいきます。 $ bundle init # Gemfile source 'https://rubygems.org' gem 'rails', '5.0.0.rc1' $ bundle install $ bundle exec rails new . --api # 上書きを確認されるので適当にYesしておく # Gemfile # 以下を追記。 # rubygemsにあるのだとRails5に対応していないのでgithubから取得していることに注意。 gem 'jsonapi-resourc
RailsでAPIサーバを開発する(AngularJS, Ruby on Rails, SPA) | DevelopersIO
RailsでJSONを返すAPIアプリケーションを３週間ぐらい試行錯誤しながら作成しています。少しですがノウハウも溜まってきたのでここにまとめておこうと思います。 今回のアプリケーションの構成は大体次のようになっています。 RailsはAPIサーバ（一般公開するAPIではなくSPA(シングルページアプリケーション)のサーバとしてJSONを返却する。HTMLは返却しない） クライアントサイドはAngularJSで画面遷移、Viewの描画まで管理する DBはMySql、Session管理はRedis（まだローカル開発なのであまり関係無い） チームはサーバサイド、クライアントサイドで完全に分担して二人で作成しています（自分はサーバサイド担当）。 このブログエントリーでは次のことを書きます。 APIのルーティングの設定(JSONのみ返すようにする方法) Session管理（CSRFトークンの受け渡
Tony Tam氏に聞く- Open API InitiativeとSwaggerの最新情報
11月の初め，Linux Foundationが発表したOAI(Open API Initiative)にあげられた華やかな創設メンバ一覧を見たAPI開発者たちは，標準に関するコンセンサスを推進するというOAIの役割に疑問を持たざるを得なかった。 Swaggerプロジェクトの創設者であるTony Tam氏は，11月末にテキサス州オースチンで開催されたAPI Strategy and Practice Conferenceで，このような疑問の中のいくつかを取り上げた。読者も関心を持つであろうこれらの疑問について，より詳しい回答を得るべく，InfoQはカンファレンスに氏を訪ねた。 InfoQ: SmartBearにおけるあなたの新たな役割と，参加を決めた理由について教えて頂けますか？ Tony Tam: 私がSmartBearに加わったのは，Swaggerの開発をフルタイムで行なうことのできる
curlとjqで簡単にAPIの調査をする - $shibayu36->blog;
ちょっとAPIを調査したいと思った時に、スクリプトを書くのも面倒なのでcurlとjqとかを利用してみたら、便利だったのでメモ。今回はTrelloをちょっといじってみた。 Redirecter ひとまずcurlでjsonを出す これは普通にcurlするだけ。 curl 'https://api.trello.com/1/boards/4d5ea62fd76aa1136000000c/cards'これでは見づらい。 curlで出たjsonをpretty化する jqに通すだけでpretty化と更に色付けされる。 curl 'https://api.trello.com/1/boards/4d5ea62fd76aa1136000000c/cards' | jq '.' curlで出たjsonの一部だけ表示する jqはjsonをいろいろ絞り込み出来る。 例えばリストの5件目まで表示。 curl 'h
Uberの急成長とそれを支える技術 - ワザノバ | wazanova
https://www.youtube.com/watch?v=GHTO2WKDO6I#t=33m43s 1 comment | 0 points | by WazanovaNews ■ comment by Jshiike | 約1時間前 Uberの技術については以前から興味ありましたが、残念ながらその点についてはあまり発信がない会社。今回、@Scale 2014に、CTOのThuan Pham（元VMWare / Westbridge / Doubleclick）とSenior Engineering ManagerのPaul Holden（元Apple）が登壇していたので、その他の情報も調べてまとめてみました。 1) 急成長 急成長という意味では、かつてはGrouponがありましたが、サイトのローカル言語/課金対応さえすれば、後は営業 + サイト運営の体制づくりというオペーレーショ
KimonoLabsと今後のサービスのあり方のはなし - プログラマでありたい
別記事にも書きましたが、第2回Webスクレイピング勉強会@東京に参加してきました。そこで注目のサービスであるKimonoLabの中の人であるPratap Ranadさんの話を聞いてきました。シンプルながら明確なメッセージで、非常に感銘を受けました。 KimonoLabsのミッション KimonoLabsの始まりは、あるサービスを作ろうとして航空会社ごとのデータを取得しようとしたことが始まりのようです。しかし、航空会社ごとにWebスクレイピングするのは手間で、非常に大変だったそうです。サイト側がAPIを提供すれば解決なのですが、APIを提供している会社は0.0005%に過ぎないそうです。またセマンティックWebにすれば良いという話もありますが、あれはデータを提供する側が努力する必要があり、そもそも構造として間違っていたとのことです。KimonoLabsはこの構造を逆転させ、データを取得する方
続・リトライと冪等性のデザインパターン - リトライはいつ成功するか - Blog by Sadayuki Furuhashi
三度の飯よりエラー処理。古橋です。 大変好評をいただいた序章リトライと冪等性のデザインパターンの続編です。 前回はほぼ前置きでしたが、今回は冪等でない操作を冪等にする具体的なテクニックもまとめていきます。 パターン２：エラーを区別してDELETEを冪等にする リソースに常に一意なIDが振られていれば、Deleteを冪等にするのは難しくない。そもそも同じリソースを2度削除することはできない。 一つ注意するべきなのは、削除されたリソースのIDが再利用されるケースでは、Deleteの冪等性は保証されない。例えば、kill -KILL <pid> コマンドはDelete系のAPIと考えられるが、pidは再利用されるので、何度も繰り返すと意図しないプロセスを殺してしまう可能性がある。 一般にIDの生成は非常に難しい問題だが、Deleteに関してのみ言えば再利用されなければいいので、単調増加する整数（
HerokuのAPIデザイン
Herokuが自ら実践しているAPIデザインガイドをGithubに公開した． “HTTP API Design Guide” このガイドは些細なデザイン上の議論を避けて，ビジネスロジックに集中すること目的としている．Heroku特有なものではなく，一般にも十分適用できる知見となっている． 最近は，モバイル向けにAPIをつくることも多いため，勉強もかねて抄訳した．なお内容は，HTTP+JSONのAPIについて基本的な知識があることが前提となっている． 適切なステータスコードを返す それぞれのレスポンスは適切なHTTPステータスコード返すこと．例えば，“成功"を示すステータスコードは以下に従う． 200: GETやDELETE，PATCHリクエストが成功し，同時に処理が完了した場合 201: POSTリクエストが成功し，同時に処理が完了した場合 202: POSTやDELETE，PATCHリク
Google対Oracle裁判、Java APIの著作権を認める判決
米OracleがJavaに関する著作権を米Googleに侵害されたと訴えている裁判で、米連邦巡回控訴裁判所は5月9日（現地時間）、対象となっているJava APIは著作権によって保護されているとする判決を下した。 Googleが主張する「フェアユース（公正利用）」については、カリフォルニア州北部地区連邦地裁に差し戻した。 この裁判は、2010年10月、AndroidでのJava利用が、Oracleの特許および著作権を侵害しているとしてGoogleをカリフォルニア州北部地区連邦地裁に提訴して始まった。Oracleは7件の特許権侵害と、37件のJava APIの著作権侵害を訴えたが、一審では2012年5月、特許侵害は認められず、またAPIは著作権保護の対象にならないとの判決が下された。なお、一審の陪審はフェアユースについての結論を出さなかった。 Oracleは2012年10月、APIが著作権保
モバイルAPIデザインのまとめ - ワザノバ | wazanova
Natasha Murashevがブログで、API Strategy and Practice Conferenceにおける、Michele Titolo (先月、「 Ruby RoguesメンバとiOSエンジニアのAPI議論」で紹介しました。）とEtsyのPaul Wrightの講演のポイントをまとめてくれています。 1) スピード ユーザは待ってくれない。300msで、リクエスト / レスポンスの処理 / ユーザに結果の表示をする。 2) RESTが常にベストとは限らない 以前のEtsyのAPIリソースはDBスキーマのミラーになっていた。クライアントがリスティングのリストを受け取ったら、ユーザがFavoritedに指定しているリスティングIDを取得するために、再度APIコールする必要があった。クライアントのAPIコールが増えると、クライアントのスピードが落ちる。また障害の可能性となるポ
拡張可能なWeb APIの設計原則と、バージョン番号を使う理由について
APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sightにはブコメしたのですが、Rebuild: 35: You Don't Need API Version 2 (Kenn Ejima)でも本件に言及があったようなので、少し一般論を書いておきたいと思います。 ■Web APIの設計原則について そもそも、良いAPIとはどのような特性をもつものでしょうか？ 一般的に、以下の２点が挙げられると思います。 拡張が容易である 拡張時に後方互換性を破壊しない ウェブの場合は、これに加え、 スケーラブルである HTTPに起因する問題に上手に対処できる ことが求められます。 前２者はウェブに限らない要件です。これを満たす設計手法としては、 リクエストおよびレスポンスのパラメータを拡張可能に 互換性を壊す拡張が必要な場合は、関数名を変える 古い関数は従来と同じ機能を
The Future of API Design: The Orchestration Layer
Daniel Jacobson (Twitter | LinkedIn), is currently director of engineering for the Netflix API. Prior to Netflix, Daniel ran application development for NPR where, among other things, he created the NPR API. He is also the co-author of APIs: A Strategy Guide. The digital world is expanding at an amazing rate, giving us access to applications and content on myriad connected devices in your homes, o
Typetalk のアーキテクチャ - API を中心にすえたサービス設計 | Typetalk ブログ
Typetalk ニュースレターを登録 Typetalk の最新情報、使い方や事例紹介などを毎月配信します。
例えば OSFA な API をやめる - @kyanny's blog
OSFA == one-size-fits-all 単一の API で全てをカバーするのをやめたらどうか、ということ。 APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight @kenn 最近はRESTfulなエンドポイントは完全に後方互換なまま、クライアントごとにオーケストレーション層(radical versionin)を設けるという方向にシフトしようとしている。詳しくは http://t.co/zODm7mFr5B— Tatsuhiko Miyagawa (@miyagawa) February 28, 2014 この話のポイントとはちょっとずれてる && Podcast 聴いてないのですが。 Quipper プラットフォームで内部的に利用されている API も、 /v1 というパスの下にはえててごく一部のエンドポイントだけ /v2 がある、み
APIのバージョニングは限局分岐でやるのが良い - Hidden in Plain Sight
ちょっと前にTwitterでAPIのバージョニングをどうやるかみたいな話をしていたのですが、そのへんもやもやしているので少し整理しておきたいなと。 APIのURLを/api/v1/*とかってやるの、やめたほうがいいとおもうんだけどなぁ。いざv2を作るとなったときに、大量のコピペが発生して後悔するよ、って伝えたい。— Kenn Ejima (@kenn) February 28, 2014 さて、これについて色々と異論・反論も含めた意見が出たのですが、まずは、大昔にURL方式（＝コントローラ分割）でやってきて後悔したぼくが、（5年ぐらい前から）現在はどうやってAPIのバージョンを管理しているか？について紹介します。 基本原理としては、コピペが多発する根っこで分岐（＝コントローラ分割）じゃなくて、必要最小限のところで限局的に分岐するのがいい、という考え方に基づきます。 一言でいうと、「パラメー
GoogleのAPIで仮名漢字変換するGem - hitode909の日記
Googleの仮名漢字変換APIを利用して，平仮名のテキストを与えると自動的に仮名漢字変換してくれる，glitch-imeというGemを作った． Google 日本語入力 - CGI API デベロッパーガイド glitch-ime | RubyGems.org | your community gem host gem install glitch-ime インスタンスを作るときにテキストを渡して，generateすると何か出してくれる． require 'glitch-ime' ime = GlitchIME.new('にわにはにわにわわにがいます') 10.times { puts img.generate } これで，こんなのができる． ﾆﾜﾆﾊﾆﾜ二話waniが鋳ます 庭には二羽丹羽ワニがイマス にわにはにわ丹羽waniがいます ニワニハニワ庭鰐が射ます ﾆﾜﾆﾊﾆﾜ二輪わにがい
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
マイクロサービス内の依存性地獄をコントロールするには - Michael Bryzak氏の講演より
Apigee
Review: Vimeo API Update Provides Robust Access to Service's Ecosystem | ProgrammableWeb
caudate.me