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

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

[nilab]

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

[ledsun]

“何も仕様が書かれていない理由は、それが大学の学生が作成したものだからだと思っていました。しかし、それは学生が書いたからではなく、そもそもAPI仕様を書くことを行ったことがない人達が書いたものだったから”

[kita-tuba]

職業プログラマーとしては、耳とか色々痛い。後悔することが多いなー

[budougumi0617]

“不備が多いAPI仕様は、不具合が多いAPI実装を生み出し、長期的な開発コストを増加させます。これは、会社内で閉じているソフトウェアでも、長期的な開発コストを増加させる結果となります。” (一部略)