元ドキュメント: Interface Description

API リファレンス

概要

ACE経済セキュリティサービスは、ゲームサーバーとの連携のためにRESTful APIインターフェースを提供します。本ドキュメントでは、主要なAPIエンドポイントの仕様を説明します。

認証

すべてのAPIリクエストにはHTTP署名認証が必要です。

Authorization: ACE {AppId}:{Signature}:{Timestamp}

ログ送信インターフェース

通貨ログ送信

POST /api/v1/economy/currency-log
Content-Type: application/json

{
    "app_id": "your_app_id",
    "logs": [
        {
            "log_id": "log_001",
            "timestamp": 1680000000000,
            "player_id": "player_123",
            "currency_type": "gold",
            "action": "earn",
            "amount": 1000,
            "balance_after": 5000,
            "source": "quest_reward"
        }
    ]
}

アイテムログ送信

POST /api/v1/economy/item-log

取引ログ送信

POST /api/v1/economy/trade-log

リスク照会インターフェース

プレイヤーリスクスコア照会

GET /api/v1/economy/risk-score?player_id={player_id}

レスポンス：

{
    "player_id": "player_123",
    "risk_score": 35,
    "risk_level": "attention",
    "risk_factors": [
        {"factor": "trade_frequency", "score": 40},
        {"factor": "behavior_pattern", "score": 30}
    ],
    "last_updated": "2026-04-07T12:00:00Z"
}

取引リスク評価

リアルタイムで取引のリスクを評価します：

POST /api/v1/economy/evaluate-trade

{
    "sender_id": "player_123",
    "receiver_id": "player_456",
    "items": [
        {"item_id": "sword_001", "count": 1}
    ],
    "currency": {"type": "gold", "amount": 10000}
}

レスポンス：

{
    "suggestion": "review",
    "risk_score": 65,
    "reasons": ["unusual_trade_value", "new_account_recipient"]
}

アクションインターフェース

プレイヤーBANリクエスト

POST /api/v1/economy/ban

{
    "player_id": "player_789",
    "ban_type": "temporary",
    "duration_hours": 72,
    "reason": "bot_farming"
}

レート制限

エンドポイント	レート制限
ログ送信	1000リクエスト/秒
リスク照会	100リクエスト/秒
アクション	10リクエスト/秒

エラーコード

コード	説明
0	成功
1001	パラメータ不正
1002	認証失敗
1003	レート制限超過
2001	内部エラー
3001	プレイヤーが見つからない