Skip to main content

GET (/users//profile/settings/people/)

取得一或多位使用者的設定檔,並支援 People Moniker。 這些 URI 的網域為 profile.xboxlive.com。

備註

userList 和 userIds 是互斥的參數。如果兩者都指定或指定其中之一,您會收到 BadRequest。userList 是一個陣列,以因應未來在需要要求多個具名清單的案例。userIds 由 XUID 的十進位字串組成,因為 JSON 不擅長序列化 64 位元不帶正負號的整數。最後,XBOX One 中的設定將會是具名設定,使用一般人類可讀的名稱,而不是 64 位元不帶正負號的整數或 XONLINE_PROFILE_ASDF 之類難懂的常數。

URI 參數

查詢字串參數

| 參數| 類型| 描述| | --- | --- | --- | --- | --- | --- | | settings| 字串| 以逗號分隔的設定名稱清單。|

必要的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 32 位元帶正負號的整數| 值 = 2| | content-type| 字串| 值 = application/json|

要求本文

範例要求

回應本文
回應是 ReadMultiSettingsResponseV2 物件。假設呼叫的使用者只有一位朋友:

另請參閱

上層
/users//profile/settings/people/?settings= Profile (JSON)
Last modified on October 6, 2026