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

※この投稿は米国時間 2022 年 12 月 1 日に、Google Cloud blog に投稿されたものの抄訳です。 オンラインで、組み立て式のテーブルを注文したとします。ところが、パッケージを開けてみると、組立説明書が入っていません。完成品がどんなものかはわかっていても、それぞれのパーツをどう組み立てればいいのか、まるでわかりません。設計が不十分な API を使うコンシューマ開発者も、同じような経験をしているといえます。適切に設計された API なら、容易に見つけ、検索してアクセスし、使用することができます。高品質の API は、コンシューマ開発者がアイデアをひらめき、新しいユースケースを作り上げる手助けになってさえくれます。 もちろん、API 設計を改善する方法はあります。たとえば、RESTful のプラクティスに従うなどです。しかし、お客様が知らず知らずのうちに、ちょっとした不便

[manFromTomorrow]

面白い読み物だったけど最終的にはApigeeの宣伝だったｗ

[xlc]

ユーザがAPIを使いこなすなんてのは幻想。少なくとも何らかのサービスを生み出した企業が相手をする話ではない。もっとわがままに「自分がサービスするのに使ったAPIを提供する」でいいのではないかね。

[matarillo]

それはシンプルじゃなくてイージーじゃないのかな。イージーなAPI好き

[akira_108]

GoogleのAPIってそんなわかりやすいと思ったことないけど

[remonoil]

ドキュメントにサンプルしか書かれていないAPI、WebpackでビルドできないクライアントライブラリのAPI、認証にOAuthしか選択肢の無いAPI

[tekmak]

ああ、graphqlて一般公開する時に使えるのか。

[verda]

“「すべての人に気に入られるもの」とはしばしば、誰にとってのベストでもない無難なものになりがち”まさに帯に短し襷に長し

[koriym]

昔からApiGeeはこの調子

[issyurn]

さいご宣伝

[yfukuda827]

基礎的な教えはいつでも役にたつ。API設計ではパラメーター名とか、同じ意味なら同じ名前にしたり気をつけてる。そういう細かいこともっと教えて欲しい

[tasukuchan]

“#”

[chiroruxx]

いいこと書いてあるな

[shoechang]

令和になってもPOSTでデータ取得すんなとか言いたくないよねぇ。