概要： APIとは、ソフトウェアシステムがリクエストとデータを交換するための、合意されたインターフェースです。ドキュメントには、操作、入力、出力、認証、制限が定義されています。
実務でAPIをどう使うか
私はAPIのプロトタイプと本番プロセスを分けます。プロトタイプでは有用性を検証し、本番では権限、制限、監視、フォールバックが必要です。出力が説得力のあるものに聞こえるからといって、事実として扱うことはありません。重要な主張は元の情報源までたどります。
注意すべきこと
最大のリスクは、不明確なプロセスを自動化することです。APIは一貫性のない出力をより速く生成し、エラーの追跡を難しくします。機微なデータ、把握できていないサービス条件、簡単には元に戻せない意思決定に注意してください。
意思決定のための質問
- この技術によって、どの限定的な作業を改善したいですか？
- どのデータを利用でき、誰が出力を確認しますか？
- 実際のケースで、精度と費用をどのように測定しますか？
- エラー後にプロセスを停止または元に戻すにはどうしますか？