L3 の SDK が提供しなければならないもの
SDK を選ぶか新しい言語に移植する場合、これが L3 のビルドターゲットです:- すべての仕様定義リソースの ライフサイクルステートマシングラフ、仕様正しいエラーコード(
NOT_CANCELLABLE/INVALID_STATEなど)を発する遷移アサーションプリミティブ付き。 - クロスペイロード衝突検出と
IDEMPOTENCY_CONFLICTエンベロープの no-payload-echo 不変条件を持つ 冪等性キャッシュ。 - 非同期タスクストア + ディスパッチャー — ツールは非同期にオプトインする。SDK は
task_idを返し、ポーリングを受け入れ、終端アーティファクトを発する。 - Webhook エミッター — 署名済み、リトライ済み、冪等。
- 解決されたアカウントが sandbox または mock モードのとき状態を決定的に駆動するよう配線された(そうでなければ拒否される)適合性テストサーフェス(
comply_test_controller)。 - 仕様のエコーコントラクトを扱う リソースごとの永続性プリミティブ。
- 上のすべてを賢明なデフォルトで結びつける サーバー構築エントリポイント。
この層のページ
- Task lifecycle — ステータス値、遷移、ポーリング。
- Async operations — 同期、非同期、インタラクティブなタスク処理。
- Webhooks — プッシュ通知、署名、リトライ、冪等性。
- Error handling — エラーカテゴリー、コード、リカバリー分類。
comply_test_controller— サンドボックス専用の適合性テストサーフェス。