마스터 플레이어 계정 삭제

POST

Admin

DeleteMasterPlayerAccount

Delete Master Player Account

curl --request POST \
  --url https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "PlayFabId": "A68C908B66C23C5",
  "MetaData": "Identifying info"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount"

payload = {
    "PlayFabId": "A68C908B66C23C5",
    "MetaData": "Identifying info"
}
headers = {
    "X-SecretKey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({PlayFabId: 'A68C908B66C23C5', MetaData: 'Identifying info'})
};

fetch('https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'PlayFabId' => 'A68C908B66C23C5',
    'MetaData' => 'Identifying info'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-SecretKey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount"

	payload := strings.NewReader("{\n  \"PlayFabId\": \"A68C908B66C23C5\",\n  \"MetaData\": \"Identifying info\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-SecretKey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"PlayFabId\": \"A68C908B66C23C5\",\n  \"MetaData\": \"Identifying info\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"PlayFabId\": \"A68C908B66C23C5\",\n  \"MetaData\": \"Identifying info\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {
    "JobReceiptId": "A101202A2CD049A0A93C9531DFB37DE8",
    "TitleIds": [
      "A248",
      "19B0"
    ]
  }
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

인증

X-SecretKey

string

header

필수

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

본문

application/json

Deletes all data associated with the master player account, including data from all titles the player has played, such as statistics, custom data, inventory, purchases, virtual currency balances, characters, group memberships, publisher data, credential data, account linkages, friends list, PlayStream event data, and telemetry event data. Removes the player from all leaderboards and player search indexes. Note, this API queues the player for deletion and returns a receipt immediately. Record the receipt ID for future reference. It may take some time before all player data is fully deleted. Upon completion of the deletion, an email will be sent to the notification email address configured for the title confirming the deletion. Until the player data is fully deleted, attempts to recreate the player with the same user account in the same title will fail with the 'AccountDeleted' error. It is highly recommended to know the impact of the deletion by calling GetPlayedTitleList, before calling this API.

PlayFabId

string

필수

Unique PlayFab assigned ID of the user on whom the operation will be performed.

MetaData

string

Developer created string to identify a user without PlayFab ID

응답

code

integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status

string

The Http status code as a string.

data

object

Show child attributes

예시:

{
  "JobReceiptId": "A101202A2CD049A0A93C9531DFB37DE8",
  "TitleIds": ["A248", "19B0"]
}

마지막 수정일 2026년 10월 6일

⌘I

Delete Master Player Account

curl --request POST \
  --url https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "PlayFabId": "A68C908B66C23C5",
  "MetaData": "Identifying info"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount"

payload = {
    "PlayFabId": "A68C908B66C23C5",
    "MetaData": "Identifying info"
}
headers = {
    "X-SecretKey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({PlayFabId: 'A68C908B66C23C5', MetaData: 'Identifying info'})
};

fetch('https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'PlayFabId' => 'A68C908B66C23C5',
    'MetaData' => 'Identifying info'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-SecretKey: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount"

	payload := strings.NewReader("{\n  \"PlayFabId\": \"A68C908B66C23C5\",\n  \"MetaData\": \"Identifying info\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-SecretKey", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"PlayFabId\": \"A68C908B66C23C5\",\n  \"MetaData\": \"Identifying info\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Admin/DeleteMasterPlayerAccount")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"PlayFabId\": \"A68C908B66C23C5\",\n  \"MetaData\": \"Identifying info\"\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {
    "JobReceiptId": "A101202A2CD049A0A93C9531DFB37DE8",
    "TitleIds": [
      "A248",
      "19B0"
    ]
  }
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

PlayFab API

PlayFab REST API References

인증

본문

응답