アカウント削除¶
特定のユーザーアカウントに関連付けられている Player ID を削除します。 アカウント削除 API はサーバー間通信を通じて動作し、アプリサーバーは Hive 認証サーバーを直接呼び出します。リクエストが成功すると、Player ID のトークンとリンクされているすべての IdP (Identity Provider) 情報が削除されます。削除後は、そのアカウントで自動ログインおよび IdP ログインを実行できなくなります。
アカウント削除機能で提供される API は次のとおりです。
| API エンドポイント | 説明 |
|---|---|
POST /v2/game/player/delete | アカウント削除 (ログイン状態) |
POST /v2/game/player/delete-project | アカウント削除 (ログイン不要) |
| ## アカウント削除 (ログイン状態) |
ユーザーがアプリにログインした状態で自分のアカウントを削除するときに使用します。
リクエスト URL¶
| 本番URL | https://auth.qpyou.cn/v2/game/player/delete |
|---|---|
| サンドボックス URL | https://sandbox-auth.qpyou.cn/v2/game/player/delete |
| HTTP メソッド | POST |
| Content-Type | application/json |
| データ形式 | JSON |
| ### リクエストヘッダー | |
| フィールド名 | 説明 |
| --- | --- |
| Authorization | アプリクライアントのログインが成功した後に返されるユーザートークン (PlayerInfo.token) |
| X-Access-Token | アプリクライアントのログイン後に発行されるユーザートークン プレーヤー本人確認用の OAuth 2.0 アクセストークン |
| ISCRYPT | データが暗号化されているかどうか (0 = 暗号化されていない、常に 0 を渡します) |
| ### リクエスト本文 | |
| フィールド名 | 説明 |
| --- | --- |
| appid | アプリID |
| did | デバイス ID |
| player_id | Player ID |
| ### レスポンスボディ | |
| フィールド名 | 説明 |
| --- | --- |
| result_code | レスポンスコード 詳細 |
| result_msg | 結果メッセージ |
| token_validation | JWT検証結果(JWT 検証エラー) |
| token_validation.result_code | JWT検証結果コード |
| token_validation.result_msg | JWT検証結果メッセージ |
| #### レスポンスコード | |
| コード値 | 説明 |
| --- | --- |
| 0 | 成功 |
| 2499 | JWT 検証が失敗しました (token_validation を参照)。 |
| 5000 | サーバー内部エラー |
| 7000 | 無効なトークン |
| 7001 | ヘッダーにトークン値がありません |
| ### リクエストの例 | |
応答例¶
成功¶
{
"result_code": 0,
"result_msg": "SUCCESS",
"token_validation": {
"result_code": 0,
"result_msg": "success"
}
}
JWT 検証の失敗¶
{
"result_code": 2499,
"result_msg": "JWT validation failed. See token_validation for details.",
"token_validation": {
"result_code": 2408,
"result_msg": "The access token is expired. Please refresh your token."
}
}
アカウント削除 (ログイン不要)¶
ユーザーがログインしていない状態でアカウントを削除するときに使用します。OAuth 2.0 アクセストークン (Project JWT) とセッショントークンで認証します。
リクエスト URL¶
| 本番URL | https://auth.qpyou.cn/v2/game/player/delete-project |
|---|---|
| サンドボックス URL | https://sandbox-auth.qpyou.cn/v2/game/player/delete-project |
| HTTP メソッド | POST |
| Content-Type | application/json |
| データ形式 | JSON |
リクエストヘッダー¶
| フィールド名 | 説明 | タイプ | 必須 |
|---|---|---|---|
| Authorization | アプリクライアントのログインが成功した後に返されるユーザートークン (PlayerInfo.token) | String | Y |
| X-Access-Token | アプリサーバー認証用の OAuth 2.0 アクセストークン OAuth トークンの発行を参照してください。 | String | Y |
| ISCRYPT | データが暗号化されているかどうか (0 = 暗号化されていない、常に 0 を渡します) | Integer | Y |
リクエスト本文¶
| フィールド名 | 説明 | タイプ | 必須 |
|---|---|---|---|
| appid | アプリ ID | String | Y |
| player_id | Player ID | BigInteger | Y |
| did | デバイス ID | Integer | Y |
レスポンスボディ¶
| フィールド名 | 説明 | タイプ |
|---|---|---|
| result_code | レスポンスコード 詳細 | Integer |
| result_msg | 結果メッセージ | String |
| token_validation | JWT 検証結果 (JWT 検証エラー) | Object |
| token_validation.result_code | JWT 検証結果コード | Integer |
| token_validation.result_msg | JWT 検証結果メッセージ | String |
レスポンスコード¶
| コード値 | 説明 |
|---|---|
| 0 | 成功 |
| 2499 | JWT 検証が失敗しました (token_validation を参照)。 |
| 5000 | サーバー内部エラー |
| 7000 | 無効なトークン |
| 7001 | ヘッダーにトークン値がありません |
リクエストの例¶
{
"appid": "com.com2us.hivesdk.normal.freefull.apple.global.ios.universal",
"player_id": 100000001,
"did": 225697886
}
応答例¶
成功¶
{
"result_code": 0,
"result_msg": "SUCCESS",
"token_validation": {
"result_code": 0,
"result_msg": "success"
}
}
JWT 検証の失敗¶
{
"result_code": 2499,
"result_msg": "JWT validation failed. See token_validation for details.",
"token_validation": {
"result_code": 2408,
"result_msg": "The access token is expired. Please refresh your token."
}
}
Note
JWT 検証が失敗した場合は、token_validation フィールドから詳細なエラー情報を確認できます。詳細については、JWT 検証エラーコードを参照してください。