跳转到主要内容
POST
Join Matchmaking Ticket

授权

X-EntityToken
string
header
必填

This API requires an Entity Session Token, available from the Entity GetEntityToken method.

请求体

application/json

Add the player to a matchmaking ticket and specify all of its matchmaking attributes. Players can join a ticket if and only if their EntityKeys are already listed in the ticket's Members list. The matchmaking service automatically starts matching the ticket against other matchmaking tickets once all players have joined the ticket. It is not possible to join a ticket once it has started matching.

Add the player to a matchmaking ticket and specify all of its matchmaking attributes. Players can join a ticket if and only if their EntityKeys are already listed in the ticket's Members list. The matchmaking service automatically starts matching the ticket against other matchmaking tickets once all players have joined the ticket. It is not possible to join a ticket once it has started matching.

Member
object
必填

The User who wants to join the ticket. Their Id must be listed in PlayFabIdsToMatchWith.

QueueName
string
必填

The name of the queue to join.

TicketId
string
必填

The Id of the ticket to find a match for.

CustomTags
object

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

响应

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
示例:
最后修改于 2026年10月6日