綺麗なAPI速習会 - Qiita

Wantedly Engineer blogに本速習会資料を閲覧向けに再編しました！ ぜひご覧いただけると幸いです！ 本記事は、綺麗なAPI速習会@Wantedlyの資料として作成されたものです。 同時にこちらのコードも参照してください。 マイクロサービス 流行りのマイクロサービス、何がいいのか 各々自由な言語やArchitectureでサービスを立てられる 障害の影響が部分的 変化に強い 個別デプロイ etc... マイクロサービス化をすすめるにあたり、やりとりは全てAPIで行う 内部のAPIであっても外部に公開できるようなクオリティのAPIを作成し、それを元にサービスを作っていくことが重要 APIGatewayとBFF API Gateway Pattern 公式サイトより 「見た目はモノリシック、実装はマイクロサービス」 一箇所見に行けば全てのAPIを見つけられる 細かい権限管理も可

[matsukaz]

更新系を複数呼ぶ場合、トランザクションどうしてるんだろ？システム分割したときの昔からの課題だけど。トランザクションリソースという話もブコメで出てるけど、そこまで対応してるのかどうかも含め気になります

[rti7743]

パスとして引数を渡そうと言うのがよくわからん。せっかく?foo=barという名前付き引数があるのにその利点を殺しているように見える。この辺りはどう理解するべき？

[june29]

この資料におけるマイクロサービスの位置付けがよくわからなかったけれど、そこを抜きにして「Web API 設計」の資料としてよくまとまっていて素晴らしいと思いました。

[k-holy]

Pagingの仕様が参考になる

[hatsu_mi]

ところどころで何いってるかわからない部分ある

[morygonzalez]

Kong で API Gateway を作る

[kymmt90]

"外部に公開してそのまま放置というAPIではなく、社内のマイクロサービスで使うAPIとして日々改善がなされ、ついでに外部にも公開されるようなAPIのあり方としてどうあるべきか考えている"

[yuki9110]

“モノリシック”

[nrtkbb]

考察を深めるきっかけになる良い資料

[Hash]

うつくしい設計

[rjge]

やり方としては綺麗だと思うけどページングにつらみを感じる

[naga_sawa]

REST API を作るときのパス階層やパラメータの考え方

[mallowlabs]

マイクロサービス/API Gateway/Backends for Frontends についてまとめられていてわかりやすい

[luccafort]

そうかGoでAPI用意すればフロントエンドが「鯖立てて欲しいんっすけど…」みたいなやりとりなくなるし、ローカルで叩けるので開発段階初期から中期あたりまでなら良さありそう。

[surume000]

無事複雑になったねー

[ymkjp]

API version 運用の知見参考になる。コントローラには最低限のロジックしか持たせずに必要に応じて潤沢に切り出せるほうが健全な気もする。

[sigwyg]

やっぱFetch綺麗だなあ

[asonas]

トランザクション（Long-running transaction）に関してはトランザクションリソースを使うとかで実装できるんでは

[yumu19]

ちょうどいま似たようなAPI設計をしてるので参考になる。

[yamadar]

綺麗なAPI

[beerbeerkun]

全く同じブコメあるけどトランザクションどう実装するんだろう

[sho]

これはすばらしい資料だ

[t-wada]

APIGateway や BFF も視野に入れた RESTful な Web API の構成と設計方法について。とくにページネーションの API に関する設計が詳しく解説されている。すばらしい。

[baronhorse]

読んでないんだけど、ネスとしたリソースどうやるのがいいかって結論出てる？

[YaSuYuKi]

ページングが参考になると同時に難しさも伝わってきてありがたいがつらい

[stealthinu]

これはよい。あと最初の図のマイクロサービスとコンテナサービスとの相性の良さがわかりやすい。

[zentarou]

APIGatewayとBFFいいな

[jojo800]

これ、行きたかったやつだ

[teracy_junk]

うちが抱えてる問題が大体解消しそうだ

[tettekete37564]

そうかVersionはリクエストヘッダに入れる手があったか。