API運用2ヶ月目：初期サイクル後の冪等性デットの管理

初期セットアップから持続的スケーリングへの移行

CPaaS統合の運用から2ヶ月目が過ぎる頃には、接続成功の初期の興奮も冷め、技術的負債という現実が表面化します。最初の30日間、開発者は基本的なメッセージ送信とDLRの受信に注力しがちです。しかし、トラフィックパターンが安定するにつれて、独自の摩擦が生じます。それが冪等性デットです。これは、迅速なプロトタイピングの段階で «Idempotency-Key» ヘッダーが省略された場合に発生し、ネットワークのリトライ時に二重請求を招きます。API請求週：二重引き落としを引き起こす冪等性の隙間で起こるような課金サイクルの問題とは異なり、この負債はリトライロジック自体における常習的な欠陥です。

不足しがちなキーの負債の特定

ホワイトラベル環境では、すべてのSMSまたはOTPリクエストが金融取引です。504ゲートウェイタイムアウトやローカルのネットワーク障害により、アプリケーションロジックが一意のキーなしでリクエストを再試行した場合、システムはそれを新しい意図として処理します。2ヶ月目には、これが内部ログとプリペイ残高の不一致として現れます。同じ宛先に対して異なるメッセージIDを持つ2つの同一のDLRが表示され、両方がアカウントから引き落とされることがあります。これはシステムエラーではなく、初期からAPIボリュームレビュー：負荷時の累進冪等性を正しく実装しなかった結果です。

プリペイ残高とJITプロビジョニングへの影響

IOSORはインフラの安定性を確保するため、厳格なプリペイモデルで運営されています。サービスを維持するため、20米ドルのプリペイフロアを設けています。冪等性デットによって重複引き落としが発生すると、このフロアに予期せぬ速度で到達し、自動的なサービス停止を引き起こす可能性があります。これは番号割当時に特に重要となります。当プラットフォームはJITロジックを採用しており、プリペイドのホールドが行われ、番号が即座に割り当てられます。適切なキーがない場合、1つの要求に対して2つの異なる番号がホールドされることがあります。

技術的比較：リトライロジックの結果

ソフトレビュー閾値を超えたスケーリング

ボリュームが拡大すると、月額1,000米ドル付近のソフトレビューに直面することになります。この段階で、当社のエンジニアリングチームはAPI使用の効率性を精査します。キーの欠落による重複リクエストの高発生率はリスク要因としてフラグが立てられます。すべてのPOSTリクエストに対して堅牢なUUIDベースのキーを実装することで、スケーリングが線形で予測可能なものになります。これにより、技術的オーバーヘッドと最適化されていないリトライループによりコストが膨らむ「2ヶ月目のサプライズ」を防ぐことができます。

IOSORでの開発開始

二ヶ月目の POST のうち Idempotency-Key がないもの、またはサーバーが最初の debit を握ったままキーが回転したものを書き出す。それらの行は負債だ。使用量を膨らませ、量の点検を乱す。残る再試行経路すべてに一意のキーを付け、ローカルタイムアウトを新しい意図と見るのをやめろ。

IOSORの要点

やる：二ヶ月目の量点検の前にキー欠落の癖を捨てる。キー TTL をクライアントタイムアウトではなく ledger 行に合わせる。

やるな：ローカル再試行窓が切れてもサーバー状態が残っているのに correlation ID に二度目の debit を刻ませること。それは負債であり、需要ではない。