API 設計: gRPC、OpenAPI、REST の概要と、それらを使用するタイミングを理解する | Google Cloud 公式ブログ

※この投稿は米国時間 2020 年 4 月 11 日に、Google Cloud blog に投稿されたものの抄訳です。 ほとんどのソフトウェア デベロッパーがご存じだと思いますが、API 設計には RPC と REST の 2 つの主要なモデルがあります。モデルに関係なく、ほとんどのモダン API は、なんらかの方法で同じ HTTP プロトコルにマッピングすることによって実装されます。また、RPC API 設計では、RPC モデルの範囲から外れずに HTTP から 1 つまたは 2 つのアイデアを採用することが一般的になっています。これにより、API 設計者に提示されるオプションの範囲が広がりました。この投稿ではこれらのオプションについて説明し、どれを選ぶか決める際に役立つガイダンスを提供します。 gRPC は RPC API を実装するためのテクノロジーで、HTTP 2.0 をその基盤

[otherworld]

そうそうRESTが良いのはエンティティ指向モデルだから。ORMのせいだろうけどREST=DB操作じゃないよ！BEに複数のデータソースがあってもそれをエンティティとして抽象化するんだよ！API設計と実装は切り離して考えよう！

[nakag0711]

DB操作という枠から外れた途端にRESTは不自然になるのでなあ

[masaki925_8107]

gRPCはHTTPマッピングを隠蔽しているのでそこの複雑性を無くせるが、ビルドやcloud endpoints 無しに気軽にエンドポイントにアクセスできなくなる。GraphQLにも登場してほしかった。。

[ngyuki]

"最も使用頻度の低い API モデルは REST です。REST という単語が広く使用（あるいは乱用）されていても、この方法で設計されている API は非常に少数です" ふむふむ

[sonots]

OpenAPI と REST は別の設計思想と語ってるけど、OpenAPI は RESTful を記述するための仕様なわけで(wikipedia調べ)、何を言ってるのか良くわからなかった

[slash_01]

読む。

[fujiten3]

個人的に怪文書だった。もっと勉強しとかないとな…

[gfx]

OpenAPIをRESTではないと言い切っているけど、少なくともOpenAPIはRESTfulを自称しているんだよなあ。GraphQLにも触れられてないし。

[koriym]

REST “このスタイルの API の特徴的な性質は、クライアントが他の情報から URL を構築せず、サーバーから渡された URL をそのまま使用することです。”

[misshiki]

それぞれの利点、欠点などがまとまっている。

[hylom]

RESTはリクエスト1発で作業が完結するような処理には向いているんだけど、そうでないものを扱おうとすると一気に面倒臭くなるのよね、しかしこのドキュメント自体も難解で理解しにくいのでは

[posbin]

“gRPC”

[prjpn]

graphqlは？

[hatakazu93]

技術

[lolence]

うわ！読まないと！

[yujiorama]

公開したい要素の性質の違いと、プログラミング言語から見た抽象度の違いかなぁ……OpenAPIはRPCの気持ちで組み立てるほうが上手くいきそうな気がしてきた

[convivial]

グーグルの考えた最強のAPI仕様、これで何回目くらいでしたっけ？

[p1ass]

gRPCでもエンティティ志向で設計した方が良いのは感覚で分かるな

[tkawa]

OpenAPIのようなスタイルのAPIはRESTではなくRPCである、と見事に喝破している

[braitom]

REST、gRPC、OpenAPIの概要、それぞれの使用方法、利点欠点がまとめられている。

[sugimomoto]

RESTの説明が丁寧