ユーザーの利用停止

Prev Next

Classic/VPC環境で利用できます。

ユーザーを指定して利用停止を実行します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /v2/memberblock

リクエストヘッダ

GAMEPOT 3.0 APIで共通して使用されるヘッダの詳細は、GAMEPOT 3.0のリクエストヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
memberId String Required ユーザー ID
  • GAMEPOT 3.0ダッシュボードの ユーザー > リスト から確認
type String Required 利用停止の分類
  • manual | autopurchase
    • manual: 手動
    • autopurchase: 自動
status Integer Required 利用停止状態
  • 1 | 2
    • 1: 有効化
    • 2: 無効化(利用停止解除)
messageMulti Array Required 利用停止理由の多言語情報: messageMulti
startedAt String Required 利用停止の開始日時
  • YYYY-MM-DD HH:mm形式
endedAt String Required 利用停止の終了日時
  • YYYY-MM-DD HH:mm形式

messageMulti

messageMultiの説明は次の通りです。

フィールド タイプ 必須の有無 説明
lang String Required 言語コード
  • ko | en | ja | zh-Hant
    • ko: 韓国語
    • en: 英語
    • ja: 日本語
    • zh-Hant: 中国語(繁体字)
value String Required 理由のメッセージ
default Boolean Required デフォルト言語かどうか
  • true | false
    • true: デフォルト言語
    • false: デフォルト言語ではない

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://dashboard-api.gamepot.ntruss.com/v2/memberblock' \
--header 'x-api-key: {API Key}' \
--header 'x-project-id: {Project ID}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
  "memberId": "cc5f0f0e-****-****-****-28ffa3cee470",
  "type": "manual",
  "status": 1,
  "messageMulti": [
      {
        "lang": "ko",
        "value": "당신은 정지되었습니다.",
        "default": true
      },
      {
        "lang": "en",
        "value": "Using the service is blocked by the admin",
        "default": false
      }
   ],
  "startedAt": "2025-09-24 00:38",
  "endedAt": "2025-09-24 06:38"
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
memberBlock Object - 利用停止履歴
memberBlock.id String - 利用停止履歴 ID
memberBlock.member_id String - ユーザー ID
memberBlock.deleted Boolean - 利用停止履歴を削除するか
  • true | false
    • true: 削除
    • false: 削除しない
memberBlock.type String - 利用停止の分類
  • manual | autopurchase
    • manual: 手動
    • autopurchase: 自動
memberBlock.status Integer - 利用停止状態
  • 1 | 2
    • 1: 有効化
    • 2: 無効化(利用停止解除)
memberBlock.message String - 利用停止の理由
  • 現在使用していないため、nullと表示
memberBlock.messageMulti Array - 利用停止理由の多言語情報: messageMulti
memberBlock.startedAt String - 利用停止の開始日時
  • ISO 8601形式
memberBlock.endedAt String - 利用停止の終了日時
  • ISO 8601形式
memberBlock.createdAt String - 利用停止履歴の作成日時
  • ISO 8601形式
memberBlock.updatedAt String - 利用停止履歴の更新日時
  • ISO 8601形式
memberBlock.deletedAt String - 利用停止履歴の削除日時
  • ISO 8601形式
memberBlock.category_id String - 利用停止分類 ID

messageMulti

messageMultiの説明は次の通りです。

フィールド タイプ 必須の有無 説明
lang String - 言語コード
value String - 理由のメッセージ
default Boolean - デフォルト言語かどうか
  • true | false
    • true: デフォルト言語
    • false: デフォルト言語ではない

レスポンスステータスコード

GAMEPOT 3.0 APIで共通して使用されるレスポンスステータスコードの詳細は、GAMEPOT 3.0のレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
  "memberBlock": {
    "id": "TWVtYmVyQ*******************************************ZjA1NTRlYWUw",
    "member_id": "cc5f0f0e-****-****-****-28ffa3cee470",
    "deleted": null,
    "type": "manual",
    "status": 1,
    "message": null,
    "messageMulti": [
      {
        "lang": "ko",
        "value": "당신은 정지되었습니다.",
        "default": true
      },
      {
        "lang": "en",
        "value": "Using the service is blocked by the admin",
        "default": false
      }
    ],
    "startedAt": "2025-09-24T00:38:00+09:00",
    "endedAt": "2025-09-24T06:38:00+09:00",
    "createdAt": null,
    "updatedAt": null,
    "deletedAt": null,
    "category_id": null
  }
}