RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ

2022/12/16 161 users ミス 設計 ウェブ API Google Cloud

※この投稿は米国時間 2022 年 12 月 1 日に、Google Cloud blog に投稿されたものの抄訳です。 オンラインで、組み立て式のテーブルを注文したとします。ところが、パッケージを開けてみると、組立説明書が入っていません。完成品がどんなものかはわかっていても、それぞれのパーツをどう組み立てればいいのか、まるでわ... 続きを読む

RESTful のウェブ API 設計で避けるべき 6 つのよくあるミス | Google Cloud 公式ブログ

2022/12/15 416 users ミス 設計 ウェブ API Google Cloud

※この投稿は米国時間 2022 年 12 月 1 日に、Google Cloud blog に投稿されたものの抄訳です。 オンラインで、組み立て式のテーブルを注文したとします。ところが、パッケージを開けてみると、組立説明書が入っていません。完成品がどんなものかはわかっていても、それぞれのパーツをどう組み立てればいいのか、まるでわ... 続きを読む

React 時代に選ぶ GraphQL - とろろこんぶろぐ

2022/07/12 30 users React GraphQL API とろろこんぶろぐ 技術選定

概要 先日新規の Web サービス開発でフロントエンド側の技術選定を行いました。 利用する技術の中で GraphQL を提案した際に、RESTful な API で呼び出す方法と比較して納得感がないという意見があがりました。 そこで、なぜ、どういうときに GraphQL を選定すべきだと思うか、文章にして自分なりにまとめておこうと思い... 続きを読む

GraphQLを推進する「GraphQL Foundation」設立、Facebookの手を離れLinux Foundation傘下へ － Publickey

2018/11/07 40 users Facebook Publickey GraphQL API

GraphQLを推進する「GraphQL Foundation」設立、Facebookの手を離れLinux Foundation傘下へ GraphQLはRESTful APIのように、APIに対して問い合わせをし、結果を受け取るための問い合わせ言語およびその仕組みです。 URLを用いることでシンプルかつ非常に自由度の高い問い合わせを表現できるRESTful APIに対して、GraphQL... 続きを読む

GraphQLとRESTfulについて今日考えてたこと　Backend for Usecase/Resourceについて - lacolaco

2018/07/12 303 users DISCLAIMER resource ベストプラクティス

DISCLAIMER: これは本当にただのメモ書きで、これがベストプラクティスだとかいう話ではないので、同じようなことを考えてる人いたら今度議論しましょうよ、って程度の話の種。 GraphQLを使うべきスポット、RESTfulが好ましいスポットについて今日ぼんやり考えていて、なんとなく言語化ができる気がするので文字起こしし... 続きを読む

「お母さん」だからこそ勉強会を主催するの巻 | いきあたりばったり

2018/07/12 27 users 勉強会 お母さん REST 初回 自分

先日とある人に「何故そんなに色んな会開いてるのか思いを聞きたい」と聞かれまして、 その時うまく答えることができなかったなーと思い、自分なりに考えてみました。 私が初めて勉強会を開いたのは約4年前。 RESTful#とは勉強会 初回のブログ RESTful#とは勉強会を開催してみたよの巻 「『REST』って何？調べてもわから... 続きを読む

GraphQLはRESTの置き換えではない｜こんぴゅ｜note

2018/05/07 129 users method GraphQL REST Body POST

GraphQLは最近注目されているWeb APIのための問い合わせ言語だ。 現在主流の RESTful なAPIはURLとmethodでリソースを表現するわけだが、GraphQLは単一エンドポイント（ex: "POST /graphql"）だけ存在し、欲しいリソースをHTTP POSTのbodyに明示的に記載してリクエストする。 ↑JSON APIをGraphQLの形式でコールする（引用:  ho... 続きを読む

grpc-gateway と使われてるProtocolBuffer周辺技術メモ - はこべにっき ♨

2018/04/21 58 users grpc-gateway リバースプロキシ grpc ツール

grpc-gateway はHTTP2+ProtocolBuffer をプロトコルに用いるgRPCのサービスを、HTTP/1.1のRESTfulな JSON APIとして利用できるようにするリバースプロキシを生成してくれるツールだ。 厳密にはProtocolBuffersを処理するコマンドである protoc のプラグインとして動作し、protocに読み込んだgRPCのサービス定義をもとにGoで記... 続きを読む

Web APIをRDBにモデル化。RESTfulもSOAPもODBC/JDBC経由で簡単にアクセス可能にする、CDataのドライバ群［PR］ － Publickey

2017/05/16 53 users CDATA ODBC Publickey RDB SOAP

Web APIをRDBにモデル化。RESTfulもSOAPもODBC/JDBC経由で簡単にアクセス可能にする、CDataのドライバ群［PR］ クラウドサービスの普及とともにさまざまなAPI、いわゆる「Web API」がインターネット上に公開されるようになりました。そしてWeb APIを組み合わせることで、これまでになかったようなアプリケーションや強力なアプリケーションを作れるようになっています。 ... 続きを読む

RESTful#とは勉強会12 · GitHub

2015/12/08 42 users GitHub

restful-towa-12.md RESTful#とは勉強会12 2015.12.08 質問はTwitterへ #RESTudy をつけてどうぞ。 「Webを支える技術」第10章 HTML 10.6 リンク (p.168) 第11章〜第13章 現在ほとんど使われていない記述があるので、飛ばしてもらってかまいません。 第11章 microformats はほとんど使われていません。現在 micr... 続きを読む

RESTful#とは勉強会で(Railsでの)ルーティングの考えだし方の話をしました - moroのブログ

2015/08/19 257 users オーケ moro Rails セクション ルーティング

2015-08-20 RESTful#とは勉強会で(Railsでの)ルーティングの考えだし方の話をしました RESTful な設計って、ってマスタメンテ作るにはいいけどまともなサービス作れるの? という疑問に対して、結構やればアプリケーションできるので安心してください、という話をしました。「独自研究」セクション以外はだいたいふつうに経験したことです。「独自研究」セクションはたぶん、今流行りのオーケ... 続きを読む

RESTful + Webcomponents で少し未来のWebサイトの作り方 | レンタルサーバーのCPIスタッフブログ

2015/06/08 33 users WebComponents レンタルサーバー 目次 想像 配信

現在記事を書いているのは2015年6月です。今回の記事では少し未来のWebサイトについて書かせていただきます。 目次 少し未来のWebサイトとは RESTful Web Serviceとは REST Web Serviceでデータを配信 データを受け取る（Webcomponents） 皆さんこれからWebサイトはどのように変わっていくと思いますか？ 色々と想像は広がるかと思いますが、少し未来のWe... 続きを読む

コマンドで確認してみたRESTful#とは勉強会4 | いきあたりばったり

2015/02/16 11 users コマンド 反省 web 休憩 集中

先日第4回目のRESTful#とは勉強会を開催致しました。 今回も時間いっぱい「webを支える技術」読書会をやりました。 前回の反省も踏まえ、休憩を入れましたが、やはり集中が最後まで続いて良かったです。 ところでこの勉強会、初心者向けとはちょっと言いがたくなってきましたね。 しかしながら、出来れば開発始める前に知っておいたほうがいい内容なので、初心者から～と幅広い層向けになってきたと思います。 既... 続きを読む

RESTful#とは勉強会2はすごかった | いきあたりばったり

2014/12/03 108 users REST アクション 興奮 会話 実践

先月末にRESTful#とは勉強会2を開催してきました。 これがもう！！！！本当に良かった！！！！勉強になった！！！まだ興奮冷めやらぬ感じです。 勉強会1回目が終わり、得たRESTの知識を私はすぐ実践に生かすことが出来ました。 「これはURLとアクション考えるとControllerもう1個用意する？」なんて会話も出るようになり、レベルアップした感があります。 2回目はどうしようかなとぼんやりしてい... 続きを読む

なんだかんだ Test::JSON::RPC::Autodoc をつくった - ゆーすけべー日記

2014/11/12 19 users RPC JSON-RPC iOS JSON autodoc

Autodoc について RESTfulもしくはそれに準ずるWeb APIやJSON-RPCなどのバックエンドとモバイルアプリ間の通信を実装する案件はおそらく昨今非常に多いかと思われます。弊社もJSON-RPCを裏方に持ち、iOSとAndroidアプリ、もしくはフロントのWebがそれを呼び出す仕組みを持っています。その際にWeb APIやRPCを呼び出すための「ルール」をどのようにお互いの技術者が... 続きを読む

API設計のポイント - ワザノバ | wazanova

2014/07/09 98 users wazanova ワザノバ SOA API設計 API

Living Socialが7回に渡りSOA (Service-oriented architecture) についてのブログを書いてますが、今回はAPI設計についてのエントリーです。 「APIはRESTful」と言うだけでなく、社内でガイドラインがオーソライズされるように調整すること。設計にあたっての選択肢及び自由度をしっかり考慮すること。そして一番大事なのは、決めた原則とおりにブレなくインプリ... 続きを読む

RESTFul(リソース指向アーキテクチャ)について - In urban breeze

2014/05/08 119 users ROA ユーザーアカウント URI 名詞 リソース

2014-05-06 RESTFul(リソース指向アーキテクチャ)について アーキテクチャ ROA(Resource Oriented Architecture)について。 次の本を参考に勉強してみた。参考図書 RESTful Webサービス ROAの基本 アプリケーションを動作と名詞(リソース)で考える。 リソースは特定のデータ、データの演算結果、状態、ユーザーアカウントなどである。 URIに動... 続きを読む

RESTfulとは

2014/03/25 223 users

・RESTという命名は、コンピューター関係の用語でよくみられるこじつけ気味の命名（HTTP、PHPとかもそう） <br /> 　「リソースの状態」（Resources State）の「表現」（REpresentational ） <br /> ・アーキテクチャスタイル <br /> 　様式、作法、流儀の意 <br /> ・XMLではなくJSONなどで返ってくるのもあり <br /> Yahoo!A... 続きを読む

CakePHPでRESTful APIを作って、Backbone.jsのデータの永続化をサーバサイドで行う | mawatari.jp

2013/08/27 116 users サーバサイド CakePHP FuelPHP API 永続化

CakePHPでRESTful APIを作って、Backbone.jsのデータの永続化をサーバサイドで行う方法をメモしておきます。RESTful APIは、FuelPHP等、その他のPHPフレームワーク、Ruby on Rails等でも簡単に作成することができますので、各々好きなものを選択してください。ここでは、CakePHPを使った例を示します。 ここで制作したアプリケーションは、以下よりダウン... 続きを読む

Web アプリケーションの認証とセキュリティに関して教えて下さい - QA@IT

2013/03/19 47 users QA@IT アプリケーション Rails サーバーサイド 認証

こんばんは。Web アプリケーションの認証とセキュリティに関して教えて下さい。 Rails のセッション管理 Rails は RESTful な Web アプリケーションの構築を可能にするとは言っていますが、実態としてはサーバーサイドに保持し、セッション ID は Cookie に保存しているものだと思っています（Rails の経験が殆ど無いので間違っていたらすみません）。 で、最近こちらの記事を... 続きを読む

Webブラウザ、Google ChromeでJSON構造の確認、編集「JSON Editor Online」|オープンソース・ソフトウェア、ITニュースを毎日紹介するエンジニア、デザイナー向けブログ

2012/12/13 100 users エンジニア ソフトウェア JSON オープンソース 編集

JSON Editor OnlineはWebブラウザやGoogle Chrome機能拡張として動作するJSONビューワー、編集ソフトウェアです。RESTfulのWeb APIなどでよく使われるようになったJSONフォーマット。構造が分かりづらかったり、自分で手作業でJSONファイルを作成したりするといった時に便利なのがJSON Editor Onlineです。 トップページです。左側がJSON、右... 続きを読む

Google App Engineを使ってAmazon S3ライクなオンラインストレージを構築「Troois」 - MOONGIFT|オープンソース・ソフトウェア紹介を軸としたITエンジニア、Webデザイナー向けブログ

2011/11/25 21 users MOONGIFT オンラインストレージ ソフトウェア 構築

Google App EngineをAmazon S3ライクに使えるようにするソフトウェアがTrooisです。RESTfulにファイルをポストして、さらに提示されたURLにGETアクセスすることでファイルのダウンロードができます。 0 続きを読む

JSONデータの授受があるWebアプリケーション開発に「JSONpad」 - MOONGIFT|オープンソース・ソフトウェア紹介を軸としたITエンジニア、Webデザイナー向けブログ

2011/09/14 40 users MOONGIFT JSON 授受 JSONデータ フォーマット

そんなRESTfulのデータやり取りの際に使われるフォーマットはJSONが多い。こちらもJavaScriptとの親和性がもちろん高い。受け取った、または送信するJSONデータの構造を確認したい時に使うのがJSONpadだ。 0 JSONpadはWebアプリケーション風のUIで作られたソフトウェアで、JSONデータをツリー構造で確認したり、さらにデータのメンテナンスができるようになっている。データタ... 続きを読む

メール送信をRESTfulに行うApacheモジュール「mod_sendmail」 - MOONGIFT|オープンソース・ソフトウェア紹介を軸としたITエンジニア、Webデザイナー向けブログ

2011/04/21 41 users MOONGIFT サーバサイド トランザクション HTML

mod_sendmailはApache用のオープンソース・ソフトウェア。Webサービスを開発するには幾つかの技術を組み合わせる必要がある。扱いやすさで言うと、HTML/JavaScript/CSS/サーバサイドの言語は問題ないだろう。若干面倒になるのがデータベースとメールだ。 LDAP認証例 メールは特に面倒くさい。ユーザ登録などでよく使われるがデータベースにトランザクションをしつつメールを送信し... 続きを読む

JavaScriptでSinatra風？RESTfulをサポートしたフレームワーク「Sammy.js」 - MOONGIFT|オープンソース・ソフトウェア紹介を軸としたITエンジニア、Webデザイナー向けブログ

2011/03/09 32 users MOONGIFT クライアントサイド サーバサイド HTML

Sammy.jsはJavaScript製のオープンソース・ソフトウェア。Webアプリケーションを開発する際には、サーバサイドとクライアントサイドの二つを開発する必要がある。クライアントサイドにはJavaScriptやFlash、HTMLなどが使われているだろう。フォームのハンドリングも可しかしJavaScriptはどんどん高度化し、機能が増している。JavaScriptだけで解決できることは日々増... 続きを読む