사용자에게 캐릭터 부여
Grants the specified character type to the user. CharacterIds are not globally unique; characterId must be evaluated with the parent PlayFabId to guarantee uniqueness.
curl --request POST \
--url https://{titleId}.playfabapi.com/Server/GrantCharacterToUser \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"PlayFabId": "20394883567",
"CharacterName": "FighterDude",
"CharacterType": "Blue Warrior"
}
'import requests
url = "https://{titleId}.playfabapi.com/Server/GrantCharacterToUser"
payload = {
"PlayFabId": "20394883567",
"CharacterName": "FighterDude",
"CharacterType": "Blue Warrior"
}
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: '20394883567',
CharacterName: 'FighterDude',
CharacterType: 'Blue Warrior'
})
};
fetch('https://{titleId}.playfabapi.com/Server/GrantCharacterToUser', 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/GrantCharacterToUser",
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' => '20394883567',
'CharacterName' => 'FighterDude',
'CharacterType' => 'Blue Warrior'
]),
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/GrantCharacterToUser"
payload := strings.NewReader("{\n \"PlayFabId\": \"20394883567\",\n \"CharacterName\": \"FighterDude\",\n \"CharacterType\": \"Blue Warrior\"\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/GrantCharacterToUser")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"PlayFabId\": \"20394883567\",\n \"CharacterName\": \"FighterDude\",\n \"CharacterType\": \"Blue Warrior\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Server/GrantCharacterToUser")
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\": \"20394883567\",\n \"CharacterName\": \"FighterDude\",\n \"CharacterType\": \"Blue Warrior\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"CharacterId": "98765432"
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}인증
This API requires a title secret key, available to title admins, from PlayFab Game Manager.
본문
Grants a character to the user of the type and name specified in the request.
Grants a character to the user of the type and name specified in the request.
Non-unique display name of the character being granted (1-40 characters in length).
Type of the character being granted; statistics can be sliced based on this value.
Unique PlayFab assigned ID of the user on whom the operation will be performed.
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
이 페이지가 도움이 되었나요?
curl --request POST \
--url https://{titleId}.playfabapi.com/Server/GrantCharacterToUser \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"PlayFabId": "20394883567",
"CharacterName": "FighterDude",
"CharacterType": "Blue Warrior"
}
'import requests
url = "https://{titleId}.playfabapi.com/Server/GrantCharacterToUser"
payload = {
"PlayFabId": "20394883567",
"CharacterName": "FighterDude",
"CharacterType": "Blue Warrior"
}
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: '20394883567',
CharacterName: 'FighterDude',
CharacterType: 'Blue Warrior'
})
};
fetch('https://{titleId}.playfabapi.com/Server/GrantCharacterToUser', 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/GrantCharacterToUser",
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' => '20394883567',
'CharacterName' => 'FighterDude',
'CharacterType' => 'Blue Warrior'
]),
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/GrantCharacterToUser"
payload := strings.NewReader("{\n \"PlayFabId\": \"20394883567\",\n \"CharacterName\": \"FighterDude\",\n \"CharacterType\": \"Blue Warrior\"\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/GrantCharacterToUser")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"PlayFabId\": \"20394883567\",\n \"CharacterName\": \"FighterDude\",\n \"CharacterType\": \"Blue Warrior\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Server/GrantCharacterToUser")
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\": \"20394883567\",\n \"CharacterName\": \"FighterDude\",\n \"CharacterType\": \"Blue Warrior\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"CharacterId": "98765432"
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}