PART 01 — 外部IF設計書
システム間連携のプロトコル・データ形式・エラー処理

■ 通信プロトコル仕様（IF-001: 在庫連携）

【基本情報】
IF-ID       : IF-001
IF名        : 在庫照会API
連携先      : 在庫管理システム（在庫管理部門）
方向        : 自システム → 在庫管理システム（リクエスト）
             在庫管理システム → 自システム（レスポンス）
トリガー    : 商品詳細ページ表示時、または注文確定前

【通信仕様】
プロトコル  : HTTPS
エンドポイント: https://inventory.internal.example.com/api/v2/stock
ポート      : 443
HTTPメソッド: POST
タイムアウト: 5秒（接続 3秒 + 読取 2秒）
リトライ    : 3回（間隔: 1秒 → 2秒 → 4秒 指数バックオフ）

【認証】
方式        : APIキー
ヘッダー    : X-API-Key: {APIキー}
APIキー管理 : システム環境変数 INVENTORY_API_KEY に格納（ソースコードに含めない）

【文字コード・フォーマット】
文字コード  : UTF-8（BOMなし）
タイムゾーン: UTC（送受信ともUTC、画面表示時にJSTに変換）

■ リクエスト（JSON）
{
  "product_codes": ["PROD-001", "PROD-002"],   // 必須 string[] 最大50件
  "request_id": "uuid-v4"                      // 必須 string トレース用
}

■ レスポンス（正常: HTTP 200）
{
  "request_id": "uuid-v4",
  "stocks": [
    {
      "product_code": "PROD-001",     // string
      "stock_quantity": 150,          // integer 0以上
      "available_quantity": 120,      // integer 引当済み分を除いた在庫
      "updated_at": "2026-06-18T03:00:00Z"  // ISO8601 UTC
    }
  ]
}

■ レスポンス（エラー: HTTP 4xx/5xx）
{
  "error_code": "INV_001",
  "error_message": "指定された商品コードが存在しません",
  "invalid_codes": ["PROD-999"]
}

"""
外部IF の疎通テストを自動化するスクリプト
pip install requests
"""
import requests, json, uuid, time

ENDPOINT = "https://inventory.internal.example.com/api/v2/stock"
API_KEY  = "your-api-key-here"
HEADERS  = {"Content-Type": "application/json", "X-API-Key": API_KEY}

TEST_CASES = [
    {"name": "正常系: 在庫あり商品",
     "payload": {"product_codes": ["PROD-001"], "request_id": str(uuid.uuid4())},
     "expect_status": 200},
    {"name": "正常系: 複数商品",
     "payload": {"product_codes": ["PROD-001","PROD-002"], "request_id": str(uuid.uuid4())},
     "expect_status": 200},
    {"name": "異常系: 存在しない商品コード",
     "payload": {"product_codes": ["PROD-999"], "request_id": str(uuid.uuid4())},
     "expect_status": 400},
    {"name": "異常系: 空配列",
     "payload": {"product_codes": [], "request_id": str(uuid.uuid4())},
     "expect_status": 400},
]

results = []
for tc in TEST_CASES:
    start = time.time()
    try:
        r = requests.post(ENDPOINT, headers=HEADERS,
                          json=tc["payload"], timeout=10)
        elapsed = time.time() - start
        ok = r.status_code == tc["expect_status"]
        results.append({"name": tc["name"], "status": r.status_code,
                         "elapsed_ms": int(elapsed * 1000),
                         "ok": ok, "body": r.json()})
    except Exception as e:
        results.append({"name": tc["name"], "ok": False, "error": str(e)})

print("=" * 60)
for r in results:
    mark = "✅" if r.get("ok") else "❌"
    print(f'{mark} {r["name"]}')
    if "elapsed_ms" in r:
        print(f'   HTTP {r["status"]} | {r["elapsed_ms"]}ms')
ng = [r for r in results if not r.get("ok")]
print(f"\n結果: {len(results) - len(ng)}/{len(results)} 件成功")