【要約】APIあるのに手入力？ 業務システムから分かるデータ連携の罠｜「項目名1つ1つの突合」から見えてきた現実 [Qiita_Trend] | Summary by TechDistill
> Source: Qiita_Trend
Execute Primary Source
// Problem
情シスや社内SEが、SaaS導入後に「APIがあるはずなのに手入力が残る」という問題に直面している。カタログ上の「API対応」という言葉だけでは、実際の業務がどの程度自動化できるか判断できない。主な課題は以下の通りである。
- ・CRUDの非対称性：仕様書からRead（取得）は確認できても、Create（作成）やUpdate（更新）の可否が不明なケースが多い。
- ・連携方向の偏り：マスタは読めるが伝票は書けないといった、オブジェクトごとの機能の片肺飛行。
- ・項目の粒度の不一致：画面上の入力項目が、APIのリクエストスキーマに存在しない、あるいは書き込めない。
- ・運用の障壁：レート制限による通信遮断や、API利用のためのプラン制約・NDA締結の存在。
// Approach
調査チームは、公開82システムのAPI仕様と画面項目を徹底的に突き合わせる一次調査を実施した。製品単位の抽象的な評価ではなく、データオブジェクト単位での詳細な検証を行っている。具体的な手法は以下の通りである。
- ・CRUD比率の集計：922のデータ対象に対し、取得・作成・更新・削除の対応状況を調査。
- ・全画面項目の突合：マネーフォワード クラウド請求書（450項目）および会計（890項目）の全項目とOpenAPI仕様を照合。
- ・運用制約の調査：レート制限の単位（秒・分・日）や、プランによるAPI開放状況を実測。
- ・業務カバー率の算出：業務入力項目（Cat-1）に絞り、APIでの完全対応・制限付き対応・非対応を分類。
// Result
実測データにより、APIによる業務自動化の真のカバー率を可視化した。製品名ではなく、対象とする業務オブジェクトによってカバー率が劇的に変化することが判明した。主な結果は以下の通りである。
- ・マネーフォワード クラウド請求書：業務入力項目の72.2%をAPIでカバー可能。
- ・マネーフォワード クラウド会計：全項目では17.5%だが、仕訳等のコア業務に絞れば81.5%に向上。
- ・設計指針の提示：導入・設計時に確認すべき「4つの防衛チェックリスト」を策定。
1.業務項目のリストアップとスキーマ照合
2.対象オブジェクトのC/U権限確認
3.内部ID解決手順の設計
4.レート制限とプラン制約の確認
Senior Engineer Insight
> APIの「有無」を鵜呑みにする設計は、運用フェーズでの手作業増大を招く。技術責任者としては、API仕様書におけるプロパティの網羅性と、CRUDの方向性をオブジェクト単位で精査すべきだ。特に、会計システム等の連携では、内部IDの解決フローや、マスタ未登録時のリカバリ運用を設計に組み込むことが不可欠である。また、バースト的なトラフィックを想定し、レート制限に基づいたリトライ戦略（指数バックオフ等）を実装レベルで検討しておく必要がある。