Accorder un personnage à l'utilisateur

Grants the specified character type to the user. CharacterIds are not globally unique; characterId must be evaluated with the parent PlayFabId to guarantee uniqueness.

Error codes

This operation may return the following PlayFab errors:

Error	Code
InvalidItemProperties	1091
ItemNotOwned	1048

POST

Client

GrantCharacterToUser

Grant Character To User

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/GrantCharacterToUser \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "CatalogVersion": "2.2",
  "ItemId": "Blue Warrior",
  "CharacterName": "FighterDude"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/GrantCharacterToUser"

payload = {
    "CatalogVersion": "2.2",
    "ItemId": "Blue Warrior",
    "CharacterName": "FighterDude"
}
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({CatalogVersion: '2.2', ItemId: 'Blue Warrior', CharacterName: 'FighterDude'})
};

fetch('https://{titleId}.playfabapi.com/Client/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/Client/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([
    'CatalogVersion' => '2.2',
    'ItemId' => 'Blue Warrior',
    'CharacterName' => 'FighterDude'
  ]),
  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/GrantCharacterToUser"

	payload := strings.NewReader("{\n  \"CatalogVersion\": \"2.2\",\n  \"ItemId\": \"Blue Warrior\",\n  \"CharacterName\": \"FighterDude\"\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/GrantCharacterToUser")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"CatalogVersion\": \"2.2\",\n  \"ItemId\": \"Blue Warrior\",\n  \"CharacterName\": \"FighterDude\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/GrantCharacterToUser")

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  \"CatalogVersion\": \"2.2\",\n  \"ItemId\": \"Blue Warrior\",\n  \"CharacterName\": \"FighterDude\"\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "CharacterId": "98765432",
    "CharacterType": "Blue Warrior",
    "Result": true
  }
}

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

Autorisations

X-Authorization

string

header

requis

This API requires a client session ticket, available from any Client Login function.

Corps

application/json

Grants a character to the user of the type specified by the item ID. The user must already have an instance of this item in their inventory in order to allow character creation. This item can come from a purchase or grant, which must be done before calling to create the character.

CharacterName

string

requis

Non-unique display name of the character being granted (1-40 characters in length).

ItemId

string

requis

Catalog item identifier of the item in the user's inventory that corresponds to the character in the catalog to be created.

CatalogVersion

string

Catalog version from which items are to be granted.

CustomTags

object

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

Réponse

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

Exemple:

{
  "CharacterId": "98765432",
  "CharacterType": "Blue Warrior",
  "Result": true
}

Dernière modification le 6 octobre 2026

Sujets connexes

Accorder un personnage à l'utilisateur Déplacer un objet de l'utilisateur vers un personnage Déplacer un objet d'un personnage vers l'utilisateur Accorder des objets à l'utilisateur Supprimer le personnage de l'utilisateur

⌘I

Grant Character To User

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/GrantCharacterToUser \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "CatalogVersion": "2.2",
  "ItemId": "Blue Warrior",
  "CharacterName": "FighterDude"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/GrantCharacterToUser"

payload = {
    "CatalogVersion": "2.2",
    "ItemId": "Blue Warrior",
    "CharacterName": "FighterDude"
}
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({CatalogVersion: '2.2', ItemId: 'Blue Warrior', CharacterName: 'FighterDude'})
};

fetch('https://{titleId}.playfabapi.com/Client/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/Client/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([
    'CatalogVersion' => '2.2',
    'ItemId' => 'Blue Warrior',
    'CharacterName' => 'FighterDude'
  ]),
  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/GrantCharacterToUser"

	payload := strings.NewReader("{\n  \"CatalogVersion\": \"2.2\",\n  \"ItemId\": \"Blue Warrior\",\n  \"CharacterName\": \"FighterDude\"\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/GrantCharacterToUser")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"CatalogVersion\": \"2.2\",\n  \"ItemId\": \"Blue Warrior\",\n  \"CharacterName\": \"FighterDude\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/GrantCharacterToUser")

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  \"CatalogVersion\": \"2.2\",\n  \"ItemId\": \"Blue Warrior\",\n  \"CharacterName\": \"FighterDude\"\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "CharacterId": "98765432",
    "CharacterType": "Blue Warrior",
    "Result": true
  }
}

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

PlayFab API

PlayFab REST API References

Accorder un personnage à l'utilisateur

Error codes

Autorisations

Corps

Réponse