Lister les tickets de remplissage de serveur d'un joueur
List all server backfill ticket Ids the user is a member of.
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| MatchmakingEntityInvalid | 2001 |
| MatchmakingQueueNotFound | 2016 |
| MatchmakingRateLimitExceeded | 2054 |
| MatchmakingUnauthorized | 2056 |
POST
/
Match
/
ListServerBackfillTicketsForPlayer
List Server Backfill Tickets For Player
curl --request POST \
--url https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer \
--header 'Content-Type: application/json' \
--header 'X-EntityToken: <api-key>' \
--data '
{
"QueueName": "custom123",
"Entity": {
"Id": "123123123",
"Type": "title_player_account",
"TypeString": "title_player_account"
}
}
'import requests
url = "https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer"
payload = {
"QueueName": "custom123",
"Entity": {
"Id": "123123123",
"Type": "title_player_account",
"TypeString": "title_player_account"
}
}
headers = {
"X-EntityToken": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-EntityToken': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
QueueName: 'custom123',
Entity: {
Id: '123123123',
Type: 'title_player_account',
TypeString: 'title_player_account'
}
})
};
fetch('https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer', 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/Match/ListServerBackfillTicketsForPlayer",
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([
'QueueName' => 'custom123',
'Entity' => [
'Id' => '123123123',
'Type' => 'title_player_account',
'TypeString' => 'title_player_account'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-EntityToken: <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/Match/ListServerBackfillTicketsForPlayer"
payload := strings.NewReader("{\n \"QueueName\": \"custom123\",\n \"Entity\": {\n \"Id\": \"123123123\",\n \"Type\": \"title_player_account\",\n \"TypeString\": \"title_player_account\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-EntityToken", "<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/Match/ListServerBackfillTicketsForPlayer")
.header("X-EntityToken", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"QueueName\": \"custom123\",\n \"Entity\": {\n \"Id\": \"123123123\",\n \"Type\": \"title_player_account\",\n \"TypeString\": \"title_player_account\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-EntityToken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"QueueName\": \"custom123\",\n \"Entity\": {\n \"Id\": \"123123123\",\n \"Type\": \"title_player_account\",\n \"TypeString\": \"title_player_account\"\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"TicketIds": [
"1c4b0daa-150e-47ae-9923-d770c0f9b07c",
"d7cf891d-1dea-4f32-9e7e-277c0a245064"
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}Autorisations
This API requires an Entity Session Token, available from the Entity GetEntityToken method.
Corps
application/json
List all server backfill ticket Ids the user is a member of.
List all server backfill ticket Ids the user is a member of.
Réponse
The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.
The Http status code as a string.
Show child attributes
Show child attributes
Exemple:
{
"TicketIds": [
"1c4b0daa-150e-47ae-9923-d770c0f9b07c",
"d7cf891d-1dea-4f32-9e7e-277c0a245064"
]
}
Dernière modification le 6 octobre 2026
Sujets connexes
Annuler tous les tickets de remplissage serveur d'un joueurLister les tickets de matchmaking d'un joueurAnnuler un ticket de remplissage serveurCréer un ticket de remplissage serveurObtenir un ticket de remplissage de serveurCette page vous a-t-elle été utile ?
⌘I
List Server Backfill Tickets For Player
curl --request POST \
--url https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer \
--header 'Content-Type: application/json' \
--header 'X-EntityToken: <api-key>' \
--data '
{
"QueueName": "custom123",
"Entity": {
"Id": "123123123",
"Type": "title_player_account",
"TypeString": "title_player_account"
}
}
'import requests
url = "https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer"
payload = {
"QueueName": "custom123",
"Entity": {
"Id": "123123123",
"Type": "title_player_account",
"TypeString": "title_player_account"
}
}
headers = {
"X-EntityToken": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-EntityToken': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
QueueName: 'custom123',
Entity: {
Id: '123123123',
Type: 'title_player_account',
TypeString: 'title_player_account'
}
})
};
fetch('https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer', 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/Match/ListServerBackfillTicketsForPlayer",
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([
'QueueName' => 'custom123',
'Entity' => [
'Id' => '123123123',
'Type' => 'title_player_account',
'TypeString' => 'title_player_account'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-EntityToken: <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/Match/ListServerBackfillTicketsForPlayer"
payload := strings.NewReader("{\n \"QueueName\": \"custom123\",\n \"Entity\": {\n \"Id\": \"123123123\",\n \"Type\": \"title_player_account\",\n \"TypeString\": \"title_player_account\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-EntityToken", "<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/Match/ListServerBackfillTicketsForPlayer")
.header("X-EntityToken", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"QueueName\": \"custom123\",\n \"Entity\": {\n \"Id\": \"123123123\",\n \"Type\": \"title_player_account\",\n \"TypeString\": \"title_player_account\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Match/ListServerBackfillTicketsForPlayer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-EntityToken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"QueueName\": \"custom123\",\n \"Entity\": {\n \"Id\": \"123123123\",\n \"Type\": \"title_player_account\",\n \"TypeString\": \"title_player_account\"\n }\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"TicketIds": [
"1c4b0daa-150e-47ae-9923-d770c0f9b07c",
"d7cf891d-1dea-4f32-9e7e-277c0a245064"
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}