コンテンツにスキップ

利用停止タイプの登録および解除

利用停止タイプの登録¶

利用停止時に適用するタイプをHiveサーバーに登録します。登録したタイプは、利用停止登録 APIで利用停止タイプ番号（block_type）パラメータとして使用します。ポップアップ形式は運営ポリシー制限（type_status=O）と一時制限（type_status=N）から選択し、韓国語と英語は必須登録言語です。コンソールガイドの認証 > 利用停止 > タイプ登録を参照してください。

Basics¶

	説明
Request URL	商用: https://auth.qpyou.cn/game/block/type/set サンドボックス: https://sandbox-auth.qpyou.cn/game/block/type/set
Method	POST
HTTP Header	Content-type: application/json ISCRYPT: 0
Response Format	JSON

Request¶

Parameter	Type	Required	Description
appid	String	O	アプリID
hive_certification_key	String	O	Hive認証キー（App Centerで発行）詳細
type_status	String	O	利用停止ポップアップ形式 `O`: 運営ポリシー制限 `N`: 一時制限
type_name	String	O	利用停止タイプ名（韓国語）最大 200 bytesまで登録できます。
type_en_name	String	O	利用停止タイプ名（英語）最大 200 bytesまで登録できます。
reasons	Array	O	利用停止理由リスト（言語別メッセージ配列）
reasons[].language	String	O	言語コード ko (韓国語) en (英語) ja (日本語) zh-hans (中国語簡体字) zh-hant (中国語繁体字) de (ドイツ語) fr (フランス語) ru (ロシア語) es (スペイン語) pt (ポルトガル語) id (インドネシア語) th (タイ語) vi (ベトナム語) it (イタリア語) tr (トルコ語) ar (アラビア語)
reasons[].title	String	O (`type_status=N`), X (`type_status=O`)	利用停止理由タイトル `type_status=N`（一時制限）の場合は必ず渡す必要があり、`type_status=O`（運営ポリシー制限）の場合に渡すとエラーが発生します。最大 200 bytesまで登録できます。
reasons[].reason	String	O	利用停止理由内容運営ポリシー制限（`type_status=O`）の場合は最大 200 bytesまで、一時制限（`type_status=N`）の場合は最大 400 bytesまで登録できます。

Response¶

Parameter	Type	Description
result_code	Integer	結果コード 0: 正常 4000: 無効なパラメータ 4002: 認証キー不一致 4014: 利用停止ポップアップ形式不一致 4015: 利用停止必須登録言語の欠落（韓国語、英語） 4016: 利用停止タイプデータの byte 制限超過 6000: 無効な appid
result_msg	String	結果メッセージ
data	Object	結果データ
data.block_type	Integer	登録された利用停止タイプ番号

運営ポリシー制限タイプ登録リクエスト¶

運営ポリシー制限タイプを登録する際はこのリクエストを使用してください。type_status値をOに設定し、言語別の利用停止理由内容をあわせて渡してください。

curl -X POST https://auth.qpyou.cn/game/block/type/set \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "hive_certification_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "type_status": "O", "type_name": "불법 프로그램 이용", "type_en_name": "Usage of unauthorized programs", "reasons": [{"language": "ko", "reason": "불법 프로그램 이용"}, {"language": "en", "reason": "Use of Unauthorized Programs"}, {"language": "ja", "reason": "使用非法程序"}]}'

一時制限タイプ登録リクエスト¶

一時制限タイプを登録する際はこのリクエストを使用してください。type_status値をNに設定し、言語別のタイトルと理由内容をあわせて渡してください。

curl -X POST https://auth.qpyou.cn/game/block/type/set \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "hive_certification_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "type_status": "N", "type_name": "임시 접속 제한(게임 데이터 수정)", "type_en_name": "Temporary access restriction (game data modified)", "reasons": [{"language": "ko", "title": "게임 이용에 불편을 드려 죄송합니다.", "reason": "현재 게임 데이터를 수정하는 중입니다. 빠른 조치를 위해 최선을 다하겠습니다."}, {"language": "en", "title": "We apologize for any inconvenience you may have experienced.", "reason": "We are currently modifying the game data. We will try our best to resolve the issue as soon as possible."}, {"language": "ja", "title": "ご利用中にご不便をおかけし、大変申し訳ございません。", "reason": "只今ゲームデータを修正しています。迅速な解決に向けて最善を尽くします。"}]}'

利用停止タイプ登録レスポンスの確認¶

タイプ登録リクエストが成功したら、レスポンスデータのblock_type値で登録された利用停止タイプ番号を確認してください。

{
  "result_code": 0,
  "result_msg": "SUCCESS",
  "data": {
    "block_type": 88
  }
}

利用停止タイプ解除¶

登録済みの利用停止タイプをHiveサーバーから削除します。現在利用停止中のユーザーデータが存在するタイプは削除できません。

Basics¶

	説明
Request URL	商用: https://auth.qpyou.cn/game/block/type/delete サンドボックス: https://sandbox-auth.qpyou.cn/game/block/type/delete
Method	POST
HTTP Header	Content-type: application/json ISCRYPT: 0
Response Format	JSON

Request¶

Parameter	Type	Required	Description
appid	String	O	アプリID
hive_certification_key	String	O	Hive認証キー（App Centerで発行）詳細
block_type	Integer	O	利用停止タイプ番号

Response¶

Parameter	Type	Description
result_code	Integer	結果コード 0: 正常 4000: 無効なパラメータ 4002: 認証キー不一致 4011: 未登録タイプ 4012: 登録された利用停止ユーザーデータが存在 6000: 無効な appid
result_msg	String	結果メッセージ

Request examples¶

curl -X POST https://auth.qpyou.cn/game/block/type/delete \
-H 'Content-Type: application/json' \
-H 'ISCRYPT: 0' \
-d '{"appid": "com.com2us.hivesdk.normal.freefull.google.global.android.common", "hive_certification_key": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJIaXZlIiwiaWF0IjoxNjAyMDU2NzI2LCJqdGkiOiIxODczMTExMzIwIn0.3soFiHTPlObCoqR5xX9ZeOQTSvnHrHDHWmopP3QfWtY", "block_type": 88}'

Response example¶

{
  "result_code": 0,
  "result_msg": "SUCCESS"
}