API仕様を書く（Mercari Engineering Blog編）
「API仕様を書く」と題して一連の記事を書きましたが、gRPCに関する内容を改めてMercari Engineering Blogとして書きました。
gRPCを用いたマイクロサービスのAPI仕様の記述
"API仕様を書く"の記事一覧
API仕様を書く（まとめ）
「API仕様を書く」として私自身の過去の経験を書いたものを読みやすく並べてみました。
API仕様を書く（1）
API仕様を書く（2）
API仕様を書く（3）
API仕様を書く（4）
API仕様を書く（5）ー gRPC protoファイル ー
API仕様を書く（6）ー gRPC protoファイル（2） ー
API仕様を…
API仕様を書く（7）
（「API仕様を書く（6）ー gRPC protoファイル（2） ー」からの続き）
きちんとしたAPI仕様を書いていない場合、そのAPIのテストコードは当然のことながら、正常ケースだけだったり、不正なパラメータが渡されたときにどのように振る舞うかは実装のソースコードを見ないと分からなかったりします。さらに、「エラー翻訳」（「例外翻…