記事

システム連携

システム連携には情報の責任者と、失敗時にも予測できる動作が必要です。API、同期、Webhookと記録の整合性を考えます。

連携は二つのURLではなく二つの業務をつなぎます。交換する記録、項目の責任元、認証、反映時間、停止時の担当者を決めます。試験リクエストが一回成功しても、確認できるのは一部です。

まず各事実の正本を決めます。物理在庫、販売可能数、価格、注文状態は同じシステムが管理するとは限りません。「双方向同期」の一言で済ませず、方向、遅延、競合処理を別々に定めます。

同期は最新の行を複製することではなく、情報の意味を保つことです。各項目をどちらが管理し、利用者がどこで変更できるかを定めます。双方向に書く前に照合と削除の規則を決めます。

通知の到着と業務処理の完了は別です。再送と順序の入れ替わりを想定します。Stripeも同社のWebhookについてこの挙動を説明しています。他の提供元はそれぞれの契約を確認してください。

古いシステムが実際に対応する入出力と、変更してよい担当者を調べます。新APIは古い仕組みを隠せますが、不安定な情報源や不明な業務ルールを消すことはできません。移行中も既存の運用を理解できる状態を保ちます。

役立つものを、一緒に。

最初のプロダクト、複雑な業務、見直したいソフトウェア。現在の状況をお聞かせください。