/serviceconfigs//sessions

支援 GET 作業，以擷取一組工作階段文件。

網域

sessiondirectory.xboxlive.com

URI 參數

參數	類型	描述
scid	GUID	服務設定識別碼 (SCID)。工作階段識別碼的第 1 部分。
keyword	string	用來篩選結果的關鍵字，只保留以該字串識別的工作階段。
xuid	GUID	要擷取其工作階段之使用者的 XBOX 使用者識別碼。使用者必須在工作階段中處於作用中狀態。
reservations	string	指出工作階段清單是否包含使用者尚未接受之工作階段的值。此參數只能設為 true。此設定需要呼叫者具備工作階段的伺服器層級存取權，或呼叫者的 XUID 宣告符合 XBOX 使用者識別碼篩選條件。
inactive	string	指出工作階段清單是否包含使用者已接受但未在積極遊玩之工作階段的值。此參數只能設為 true。
private	string	指出工作階段清單是否包含私人工作階段的值。此參數只能設為 true。只有在查詢您自己的工作階段，或以伺服器對伺服器方式查詢時才有效。將此參數設為 true 時，需要呼叫者具備工作階段的伺服器層級存取權，或呼叫者的 XUID 宣告符合 XBOX 使用者識別碼篩選條件。
visibility	string	指出用於篩選結果之可見性狀態的列舉值。目前此參數只能設為 Open，以包含開放的工作階段。請參閱 MultiplayerSessionVisibility。
version	string	正整數，指出要包含之工作階段的主要工作階段版本 (或更低版本)。此值必須小於或等於要求的合約版本除以 100 的餘數。
take	string	正整數，指出要擷取的工作階段數目上限。

有效的方法

GET (/serviceconfigs//sessions) 擷取指定的工作階段資訊。

另請參閱

上層

工作階段目錄 URI

Last modified on October 6, 2026

⌘I