記事「実践API設計」

WEB+DB PRESS Vol.134

• 出版社/メーカー: 技術評論社
• 発売日: 2023/04/22
• メディア: 単行本（ソフトカバー）

雑誌の記事を最後に執筆したのは、「Software Engineer Vol.1」（技術評論社、2007年4月）だったので、16年振りに記事を書きました。

堅牢で、保守性に優れたWebサービスの実現
仕様ファーストでいこう！
実践API設計

ウェブサービスの開発に従事するようになったのは、リコーを早期退職して、2017年9月から働き始めたソラミツからでしたが、その後、メルペイ、現在のカウシェと、バックエンドのサービス開発に従事しています。実際に本番サービスとして使われるサービスを開発したのはメルペイからです。

私自身は、1984年に就職してからのワークステーション開発、その後のデジタル複合機開発と長年ウェブサービスには関わることはありませんでした。2018年6月からメルペイでマイクロサービスの開発に従事したときに考案して、その後、さまざまなマイクロサービスの開発、および、現在のカウシェでも実践していることを記事としてまとめています。発売は、4月22日です。

5章から構成されます。

第1章　優れたAPI 仕様とは何か
　　　　よくある問題点と、記述すべき事柄
第2章　gRPC におけるAPI 仕様の書き方
　　　　サービスの概要、エンドポイントの説明、エラーの説明
第3章　API 仕様ファースト開発
　　　　仕様を先に記述し、テスト駆動で開発する
第4章　E2E テストフレームワークの構築
　　　　API 仕様ファースト開発のための独自実装
第5章　API 仕様の技術的負債の返済
　　　　サービスの成長を支えるための改善活動