元ドキュメント: Universal Asynchronous Moderation Interface

汎用非同期モデレーション インターフェース

概要

汎用非同期モデレーションインターフェースは、画像・音声・動画など様々なメディアコンテンツを非同期に検査するためのAPIです。検査リクエストを送信後、コールバックURLまたはポーリングで結果を受信します。

インターフェース情報

項目	内容
リクエストURL	https://api.anticheatexpert.com/v1/async/check
リクエストメソッド	POST
Content-Type	application/json
認証方式	HTTP署名検証

リクエストパラメータ

パラメータ	型	必須	説明
app_id	string	✅	アプリケーションID
content_type	string	✅	コンテンツ種別（image / audio / video）
content_url	string	✅	コンテンツのURL
user_id	string	❌	ユーザーID
scene_id	string	❌	シーンID
callback_url	string	❌	結果通知コールバックURL

リクエスト例

POST /v1/async/check HTTP/1.1
Host: api.anticheatexpert.com
Content-Type: application/json
Authorization: {signature}

{
    "app_id": "your_app_id",
    "content_type": "image",
    "content_url": "https://example.com/image.jpg",
    "user_id": "player_12345",
    "callback_url": "https://your-server.com/callback"
}

レスポンス（送信確認）

{
    "request_id": "req_async_001",
    "status": "accepted",
    "message": "Task queued for processing"
}

コールバックレスポンス

{
    "request_id": "req_async_001",
    "result": {
        "suggestion": "review",
        "label": [
            {"category": "nudity", "confidence": 0.78}
        ],
        "content_type": "image",
        "processing_time_ms": 350
    }
}

結果ポーリング

コールバックURLを指定しない場合、以下のエンドポイントで結果を照会できます：

GET /v1/async/result?request_id=req_async_001

対応コンテンツ形式

種別	対応形式
画像	JPEG, PNG, GIF, WebP, BMP
音声	MP3, WAV, OGG, AAC
動画	MP4, AVI, MOV, WebM

エラーコード

コード	説明
0	成功（タスクキューイング完了）
1001	パラメータ不正
1002	認証失敗
1004	コンテンツURLアクセス不可
1005	ファイルサイズ超過
2001	内部エラー