あなたの運用ポリシーに従い、Hive サーバーでアカウントを一時停止する機能を提供しています。Hive コンソールで一時停止の種類を事前に登録することで、永久に一時停止されたユーザーと一時停止期間を持つユーザーを区別して登録できます。さらに、すでに登録されているユーザー（PlayerIDで区別）について、一時停止の種類と一時停止期間を変更することができます。
基礎
| リクエストURL | - 本番: https://auth.qpyou.cn/game/block/set
- サンドボックス: https://sandbox-auth.qpyou.cn/game/block/set
|
| メソッド | POST |
| HTTPヘッダー | - Content-type: application/json
- ISCRYPT: 0
|
| レスポンスフォーマット | JSON |
リクエスト
| パラメーター | タイプ | 必須 | 説明 |
| appid | 文字列 | O | AppID |
| player_id | 整数 | O | Player ID (サンドボックス環境で使用) |
| hive_certification_key | 文字列 | O | 認証キー（App Centerから発行されたもの） |
| status | 文字列 | O | 停止状況 - `P`: 永久停止
- `B`: 停止期間のあるユーザー
|
| block_type | 整数 | O | 利用停止タイプ番号 (Hive コンソールに登録されている必要があります: Hive コンソール > 認証 > 使用停止 > 種類登録) |
| start_date | 文字列 | O | 停止開始日 |
| end_date | 文字列 | O | 停止終了日 |
レスポンス
| パラメータ | タイプ | 説明 |
| result_code | 整数 | 結果コード - 0: 成功
- 4000: 無効なパラメータ
- 停止開始日と終了日の形式が不正な場合
- 開始日が終了日より後の場合
- 現在の時間が終了日より後の場合
- 4002: 認証キーの不一致
- 4011: 登録されていないタイプ
- 6000: 無効なappid
|
| result_msg | 文字列 | 停止の原因に関する結果メッセージ |
リクエストの例
curl -X POST https://auth.qpyou.cn/game/block/set
-H 'Content-Type: application/json'
-H 'ISCRYPT: 0'
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "status" : "B", "block_type" : 18, "start_date" : "2024-06-03 00:00:00", "end_date" : "2024-06-30 23:59:59"}'
応答の例
{
"result_code": 0,
"result_msg": "SUCCESS"
}
サスペンションからユーザーを解除する
Hiveサーバーで特定のアカウントを直接停止解除します。
基礎
| リクエストURL | - 本番: https://auth.qpyou.cn/game/block/delete
- サンドボックス: https://sandbox-auth.qpyou.cn/game/block/delete
|
| メソッド | POST |
| HTTPヘッダー | - Content-type: application/json
- ISCRYPT: 0
|
| レスポンスフォーマット | JSON |
リクエスト
| フィールド | タイプ | 必須 | 説明 |
| appid | 文字列 | O | AppID |
| player_id | 整数 | O | PlayerID |
| hive_certification_key | 文字列 | O | 認証キー（アプリセンターで発行される） |
応答
| フィールド | タイプ | 説明 |
| result_code | 整数 | - 0: 成功
- 2002: ユーザーは停止されていません
- 4000: 無効なパラメータ
- 4002: 認証キーの不一致
- 6000: 無効なappid
|
| result_msg | 文字列 | 結果メッセージ |
リクエストの例
curl -X POST https://auth.qpyou.cn/game/block/delete \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid" : "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal", "player_id" : 24000000000, "hive_certification_key" : "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY"}'
応答の例
{
"result_code": 0,
"result_msg": "SUCCESS"
}