플레이어 사용자 지정 속성 가져오기
Retrieves a title-specific custom property value for a player.
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| PlayerCustomPropertiesPropertyDoesNotExist | 19007 |
POST
/
Client
/
GetPlayerCustomProperty
Get Player Custom Property
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"PropertyName": "level"
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty"
payload = { "PropertyName": "level" }
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({PropertyName: 'level'})
};
fetch('https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty', 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/Client/GetPlayerCustomProperty",
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([
'PropertyName' => 'level'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <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/Client/GetPlayerCustomProperty"
payload := strings.NewReader("{\n \"PropertyName\": \"level\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<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/Client/GetPlayerCustomProperty")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"PropertyName\": \"level\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"PropertyName\": \"level\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"Property": {
"Name": "level",
"Value": 5
},
"PropertiesVersion": 12
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}인증
This API requires a client session ticket, available from any Client Login function.
본문
application/json
Specific property name to search for in the player's properties.
마지막 수정일 2026년 10월 6일
관련 항목
플레이어 사용자 지정 속성 가져오기튜토리얼 플레이어 프로필 가져오기타이틀 관리 리더보드 가져오기플레이어 사용자 지정 속성Economy(레거시)에서 플레이어의 VTD(Value-to-Date) 가져오기이 페이지가 도움이 되었나요?
⌘I
Get Player Custom Property
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"PropertyName": "level"
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty"
payload = { "PropertyName": "level" }
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({PropertyName: 'level'})
};
fetch('https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty', 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/Client/GetPlayerCustomProperty",
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([
'PropertyName' => 'level'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <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/Client/GetPlayerCustomProperty"
payload := strings.NewReader("{\n \"PropertyName\": \"level\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<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/Client/GetPlayerCustomProperty")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"PropertyName\": \"level\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/GetPlayerCustomProperty")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"PropertyName\": \"level\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"Property": {
"Name": "level",
"Value": 5
},
"PropertiesVersion": 12
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}