Obter estatísticas do jogador

Retrieves the current version and values for the indicated statistics, for the local player.

Error codes

This operation may return the following PlayFab errors:

Error	Code
ProductDisabledForTitle	1609

POST

Server

GetPlayerStatistics

Get Player Statistics

curl --request POST \
  --url https://{titleId}.playfabapi.com/Server/GetPlayerStatistics \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "PlayFabId": "621EF2023753444",
  "StatisticNames": [
    "Points",
    "Wins"
  ]
}
'

import requests

url = "https://{titleId}.playfabapi.com/Server/GetPlayerStatistics"

payload = {
    "PlayFabId": "621EF2023753444",
    "StatisticNames": ["Points", "Wins"]
}
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: '621EF2023753444', StatisticNames: ['Points', 'Wins']})
};

fetch('https://{titleId}.playfabapi.com/Server/GetPlayerStatistics', 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/Server/GetPlayerStatistics",
  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' => '621EF2023753444',
    'StatisticNames' => [
        'Points',
        'Wins'
    ]
  ]),
  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/Server/GetPlayerStatistics"

	payload := strings.NewReader("{\n  \"PlayFabId\": \"621EF2023753444\",\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\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/Server/GetPlayerStatistics")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"PlayFabId\": \"621EF2023753444\",\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Server/GetPlayerStatistics")

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\": \"621EF2023753444\",\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "PlayFabId": "621EF2023753444",
    "Statistics": [
      {
        "StatisticName": "Points",
        "Value": 570,
        "Version": 1
      },
      {
        "StatisticName": "Wins",
        "Value": 15
      }
    ]
  }
}

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

Autorizações

X-SecretKey

string

header

obrigatório

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

Corpo

application/json

PlayFabId

string

obrigatório

user for whom statistics are being requested

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

StatisticNames

string[]

statistics to return

StatisticNameVersions

object[]

statistics to return, if StatisticNames is not set (only statistics which have a version matching that provided will be returned)

Show child attributes

Resposta

In addition to being available for use by the title, the statistics are used for all leaderboard operations in PlayFab.

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

In addition to being available for use by the title, the statistics are used for all leaderboard operations in PlayFab.

Show child attributes

Exemplo:

{
  "PlayFabId": "621EF2023753444",
  "Statistics": [
    {
      "StatisticName": "Points",
      "Value": 570,
      "Version": 1
    },
    { "StatisticName": "Wins", "Value": 15 }
  ]
}

Última modificação em 6 de outubro de 2026

⌘I

Get Player Statistics

curl --request POST \
  --url https://{titleId}.playfabapi.com/Server/GetPlayerStatistics \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "PlayFabId": "621EF2023753444",
  "StatisticNames": [
    "Points",
    "Wins"
  ]
}
'

import requests

url = "https://{titleId}.playfabapi.com/Server/GetPlayerStatistics"

payload = {
    "PlayFabId": "621EF2023753444",
    "StatisticNames": ["Points", "Wins"]
}
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: '621EF2023753444', StatisticNames: ['Points', 'Wins']})
};

fetch('https://{titleId}.playfabapi.com/Server/GetPlayerStatistics', 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/Server/GetPlayerStatistics",
  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' => '621EF2023753444',
    'StatisticNames' => [
        'Points',
        'Wins'
    ]
  ]),
  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/Server/GetPlayerStatistics"

	payload := strings.NewReader("{\n  \"PlayFabId\": \"621EF2023753444\",\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\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/Server/GetPlayerStatistics")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"PlayFabId\": \"621EF2023753444\",\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Server/GetPlayerStatistics")

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\": \"621EF2023753444\",\n  \"StatisticNames\": [\n    \"Points\",\n    \"Wins\"\n  ]\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "PlayFabId": "621EF2023753444",
    "Statistics": [
      {
        "StatisticName": "Points",
        "Value": 570,
        "Version": 1
      },
      {
        "StatisticName": "Wins",
        "Value": 15
      }
    ]
  }
}

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

PlayFab API

PlayFab REST API References

Obter estatísticas do jogador

Error codes

Autorizações

Corpo

Resposta