API仕様を書く（7）：柴田 芳樹 (Yoshiki Shibata)：So-netブログ

API仕様を書く（7）：柴田 芳樹 (Yoshiki Shibata)：So-netブログ

（「API仕様を書く（6）ー gRPC protoファイル（2） ー」からの続き） きちんとしたAPI仕様を書いていな...概要を表示 （「API仕様を書く（6）ー gRPC protoファイル（2） ー」からの続き） きちんとしたAPI仕様を書いていない場合、そのAPIのテストコードは当然のことながら、正常ケースだけだったり、不正なパラメータが渡されたときにどのように振る舞うかは実装のソースコードを見ないと分からなかったりします。さらに、「エラー翻訳」（「例外翻訳」）を行っていない実装は、いつのまにか返されるエラーが変わってしまっていることも起こり得ます。 おそらく多くの大学ではAPI仕様の書き方も含めてAPI設計の教育は行われていないと思います。そして、社会人となってから、個々のソフトウェアエンジニアがAPIの仕様をどの程度記述するかは、その人が属したソフトウェア開発組織の文化に影響を受けると思います。 私自身、gRPCを用いたソフトウェア開発では、前職のソラミツが初めてでした。そこでは、protoファイルには何も仕様

• api