刪除主要玩家帳戶

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

授權

主體

回應