シンプルさとパフォーマンスを両立した API 設計と実装の一例 - HeartRails Tech Blog
こんにちは、エンジニアの村田です。今回はシンプルさとパフォーマンスを両立した API を作るためにはどうすればよいのかについて述べていきます。 背景 いままで API サーバーを作ってきて、シンプルな API にすればパフォーマンスが犠牲に、パフォーマンスを優先すれば実装が複雑になって保守が大変になるということを経験してきました。具体的には、 関連リソースの Entity が何重にもネストしていたり、同じリソースに一覧用、詳細用などの Entity があり実装、保守が大変 1. の問題を解消するためにシンプルな API にする 2. では N+1 の問題がありパフォーマンスが悪い 1. 2. の問題を解消するためにリソースの Entity はシンプルにしつつ、パラメーターで関連リソースを指定すると関連リソースの Entity を埋め込んで返すようにする 4. だと関連リソースの権限管理やペ
サイ本こと『JavaScript 第6版』全800ページを読破し、1万行のesaにまとめてわかった5つのこと - #がみぶろ
しがないラジオのgamiです。 JavaScript界隈では有名な、オライリーのサイ本こと『JavaScript 第6版』という鈍器、もとい書籍を読みました。 JavaScript 第6版 作者: David Flanagan,村上列出版社/メーカー: オライリージャパン発売日: 2012/08/10メディア: 大型本購入: 12人 クリック: 252回この商品を含むブログ (18件) を見る 2012年に発行された、約800ページもある、かなり内容の多い本です。 僕は本を読むときにesaに要約しながら読み進めるのですが、サイ本のまとめesaは全体で「約1万行」という修行みたいな分量になっていました。 サイ本、3年越しくらいでやっと読み終わったあああああ！！！esaにまとめながら読んでたけど、コードも含めて約23万字、1万行の分量になっててesaが悲鳴あげてたw今度感想ブログ書く。多くの人
フロントエンド向けの API サーバリニューアルに GraphQL を検討している話 - エムスリーテックブログ
エムスリーでマルチデバイスチームのチームリーダーをしている松原@ma2geです。 マルチデバイスチームはこちらのテックブログでは初出なので簡単に紹介すると、iOS や Android 等のデバイス対応を主導する開発するチームで、主に iOS, Android のネイティブアプリ開発から、アプリから叩く API サーバ(いわゆる Backends For Frontends(BFF))、プッシュ通知基盤システムのバックエンドサービスも開発しております。 私自身は3月までは別チームで Rails/Java/Elixir などを触っていましたが、4月から現チームに移動しこちらでもまた新たな挑戦をさせてもらっています。 💪 前提 今回はネイティブアプリ向けの RESTful な API サーバがレガシーとなっており、このサーバのリニューアルを検討している話を書きます。 対象のサーバはフレームワー
Meetup #6 GraphQL Tokyo Summer がFiNCにて開催されました
技術開発本部の qsona (twitter: @qsona) です。 GraphQLに関してのユーザコミュニティである GraphQL Tokyo のMeetup #6が行われ、FiNCがスポンサーとして会場・食事・飲み物の提供を行いました。 GraphQL TokyoのMeetupはオープンスペース方式で、各セッションでGraphQLに関するテーマを1つ取り上げて少人数で議論していきます。どのセッションも議論に花が咲き、とても盛り上がりました！ 共同主催者の joe_re さん, Yosuke Kurami さん, mtsmfm さん, taiki-t さん, 素晴らしい会をありがとうございました。ユーザコミュニティの運営は継続的な熱意が必要で大変だと思います。GraphQLの日本への普及に大きな役割を果たしていて、頭が下がる思いです。私個人としては2回目の参加でしたが、2回とも新しい
雑に始める GraphQL Ruby【class-based API】 - Qiita
まずはじめに 目的 この記事は、これからgraphqlをはじめる、もしくはgraphql始めたてにおいて知っておくと良さそうな情報(と、そこへのindex)をまとめることを目的に書いています。 想定読者は「これからgraphql始めたい人、始めたばかりの人」です。 その背景として、graphqlベースのAPIがもっと増やすべく、その導入/学習コストがそこまでは高くないことを説明したい、ということがあります。 ------8<------- 以下宣伝 ------8<------- なお、 Issus(イシューズ) という個人向けマークダウンノートサービスの中でGraphqlを使う中で得た情報をまとめています。 ------8<------- 以上宣伝 ------8<------- 概要 Graphqlのコンセプト、特徴、強み、という概念としての話から、 リクエスト/レスポンスの流れ、クエ
コーディングをするときに鼻血がでるほど便利なwebツールリスト - Qiita
普段お世話になっているwebツール達の紹介です。 以下のサイトはすべて 無料 & 登録不要 です。 正規表現 regexper 正規表現を可視化してくれます。 複雑な正規表現を書くときやコードリーディングのお供に重宝します。 Rubular Rubyの正規表現をテストできます。 JSON JSON FORMATTER & VALIDATOR JSON系のツールが集まったサイト。 それぞれ、サイト名とドメインが違うのでリンクはそのうちの１つになっています。 (画像クリックでそれぞれのツールに飛べます。) ひとつずつ紹介します。 JSONをフォーマットしてくれます。 出力結果は折りたたむことができるので、長いJSONを読むときにも便利です。 JSONを含めた様々なデータ形式を変換できます。 Inputの以下に対応。 CSV INI JSON XML YAML Outputは以下に対応。 JSO
GraphQL Ruby の使い方 (基礎編) - Qiita
注意 現在の graphql-ruby （ver: 1.8.x） は Ruby のクラスベースによる定義がメインで、この記事に書いてある DSL を使った定義は 非推奨 です。 ロードマップ には DSL を使った .define-style は、graphql-ruby 2.0 で廃止するとあります。 新しいクラスベースでの書き方は 公式ドキュメント を御覧ください。 日本語の記事だと @gfx さんの 「GraphQL」徹底入門 ─ RESTとの比較、API・フロント双方の実装から学ぶ が非常によくまとまってて分かりやすいです。 はじめに 私が携わっているプロダクトでは、フロントエンド用のAPIとしてGraphQLを採用しました。 実際に使ってみてかなり良い感じなのですが、最初はいざ実装しようにもよく分からずに苦労しました。 そこで、GraphQL の実装方法についてサーバーサイドに焦
GraphQLを使ったAPI仕様中心開発の導入とその効果の紹介 - Kaizen Platform 開発者ブログ
Kaizen Platformでフロントエンド開発をやっているlacoです。 新規アプリケーション開発において、API仕様中心の開発スタイルを検討し、実験的に取り入れました。 本記事ではその概要と効果を紹介します。 API仕様中心開発 API仕様中心開発を取り入れようと思ったきっかけは、2017年のNode学園祭でpika_shiさんが発表した「JSON Schema Centralized Design」です。 JSON Schema Centralized Design - Speaker Deck Kaizen Platformではリモートワークで開発しているメンバーが多く、非同期にコミュニケーションをすることが多いので、生産性を高めるためには互いの作業を待たずに独立して分業できるワークフローが必要でした。 バックエンドAPIの実装を待たないとフロントエンドが実装できないような依存関
プライベートでコードを毎日書き続けて２年以上が過ぎた
いつの間にか２年間継続してコードを書いていたので、その振り返りです。上のインコは日々僕を応援してくれる二羽のインコのうちの一羽です。この後本をボロボロに噛みちぎっていきました。 １年目との違い去年こんなポストを書きました。 このとき、自分はコードを１年継続して書いたわけですが、その後また１年継続してコードを書いていました。 １年目とは「書きたい」と思うものも変わりました。また、習慣を維持する労力も小さくなり、コードを書くことそのもの以外の、登壇などの時間を取れるようになりました。 この１年で新たにやったことツール作成markdownをMediumポストにするCLIツールAWS SSMで管理されたパラメーターを環境変数にInjectするツールGoogle Cloud Platform API向けに使える、goonと同様のDatastoreクライアント基盤作成AWS上にTerraform+An
気象庁のデータをJSON化するAPIのようなものを作った - Qiita
追記 2020-09-13 追記：作り直しました。 新しい記事をご覧ください https://qiita.com/ryo-a/items/4468ffdbf251ec31dace 以下は古い記事です。 ryo-a と申します。 普段は大学生(B2)をやりつつ、ドワンゴの教育事業本部にてアルバイトとして N予備校プログラミング教材の編集をお手伝いしたり、ElectronというフレームワークのWebサイト/ドキュメント翻訳に参加したりしております。 ちょっと前までは C# で Windows 向けアプリケーションを書いていましたが、最近はもっぱら Node.js で遊んでいます。 こんなもの作りました http://jjwd.info/ JSONized Japanese Weather Data - Developer Friendly Open Data Optimization Proj
Rails + swagger-blocks で OpenAPI 形式の API ドキュメントを作成する
この記事では、Rails で書いた JSON API サーバそれ自体の API エンドポイント仕様ドキュメントを OpenAPI 形式の JSON データとして生成し、そのデータを API 自体から取得する方法を説明します。 つまり、次のようなエンドポイント { "swagger": "2.0", "info": { "version": "1.0.0", "title": "Sample App", "description": "This is a sample app.", "contact": { "name": "@kymmt90" }, "license": { "name": "MIT" } }, // ... "paths": { "/users": { "post": { "description": "Creates a user", "operationId": "c
ホテルBot の使い方 - Qiita
ホテルBot って何？ ホテル検索用のLINE Bot です。 LINEで”札幌で明日から２泊、一万円以下の禁煙ルームで朝食あり” のようにテキストメッセージで条件指定するだけで、条件にあったホテルの検索結果を返してくれるLINE Botです。 自然言語処理を使っているので、ウィザード形式のように「地名」「日程」「金額」「条件」を尋ねられながら都度入力していくのではなく、一回メッセージを送るだけで検索まで出来るので、手間なく簡単に希望のホテルを探すことができます。 また、検索結果からすぐにホテル予約ができることはもちろん、Google カレンダーやEVERNOTE に予約したプランや気になったプランの情報を登録しておくこともできます。 ホテルBot を使うには ホテルBot はLINE用Bot ですので、LINE アプリの「友だち追加」から下のQRコードを読み取って、友だちに追加してくださ
WebAPIについての説明 - Qiita
はじめに 新人への説明の為に書きました。 元々は社内勉強会用のスライドのメモだったものを、いい感じに直して公開する事にしました。 「勉強は真面目にするものだ」と考えている人には向きません。 「技術的な事は正確でなければいけない」と考えている人には向きません。 基本的な事から馬鹿丁寧に書いてあるので長いです。時間ある時用の記事です。 誤解を生じるぐらい噛み砕いて簡単に説明してあります。 教科書的に通して読むことでWebAPIが理解出来るように書いてあります。 対象者 htmlとcssは書ける phpとjsを主にコピペでしか書けない IT関連の基本的な用語も知らない、理解してない WebAPI？何それおいしいの？っていう人 どちらかと言うと営業寄りの部署に所属 アジェンダ 第1部 知識編 WebAPIの 仕組みを理解する 用語を理解する 第2部 実践編 WebAPIを作る WebAPIを利用す
Rails + Grape + API Key Authentication
When adding a Grape API to an existing Rails application you have a few options for user authentication. Probably the simplest and most basic way to authenticate an API is by issuing API keys to your users. How it works…User submits their Username/Password to the API.API authenticates the user and returns an API Key.For all subsequent API requests, the user submits the key with their request. This
Grape+SwaggerでAPIのドキュメント作成を自動化した - 弥生開発者ブログ
こんにちは、Misoca開発チームのいっしーです。 11月からMisocaにJoinしました。 10年ほど東京にいたので、未知の土地に新鮮な気持ちでいます。 名古屋の好きなところはB級グルメがたくさんあるところ、こわいところは学生時代に学んでいた関数型言語OCamlや自然言語の形式理論の話がナチュラルに通じてしまうところです。 さて、そんな私の初仕事であるMisoca API v3が先日リリースされました。 見積書や取引先をAPI経由で扱えるようになっています。 www.misoca.jp また、技術面ではGrapeとgrape-swaggerを新たに導入しました。 今回はこれらについて紹介したいと思います。 背景 Misoca API v1 (以後、v1とします) では、Rails標準のControllerでリクエストを受け付け、結果をjson形式などでレスポンスを返す形を取っていました
Swaggerで始めるAPI定義管理とコードジェネレート
iOSDC 2017 2017/09/15@早稲田大学理工学部西早稲田キャンパス 63号館 Yohei Suginami ( @susieyy )
Reactでシンセサイザーを作った話 - Speee DEVELOPER BLOG
こんにちは、nishayaです。 管理部のエンジニアとして、社内向けのシステムを作ったり、 社内で開催されるイベントでコーヒーを淹れたりしています。 社内向けだからこそできる冒険もある、ということで、 現在はReact/Reduxを用いたSPA開発を行っています。 今回のSpeeeKaigi(下記の記事を参照)では、 ReactとReduxを使ってシンセサイザーを作る話をしました。 tech.speee.jp 発表資料 使用したもの React Redux Web MIDI API Web Audio API Web MIDI APIを使用しているため、今回のターゲットブラウザはGoogle Chromeのみとしました。 そのため、webkit プレフィクス付きのAudioContextにも対応していません。 モチベーション 業務でSPA開発にReact/Reduxを使用するという決定をし
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
REST API に疲れたあなたへ贈る GraphQL 入門
RESTfulとは
質の高いAPIを作るための7つの習慣
