ユーザーへのキャラクターの付与
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": {}
}