Skip to main content

GET (/users/xuid())

探索其他使用者或用戶端的狀態。 這些 URI 的網域為 userpresence.xboxlive.com。

備註

如果取用者對整個物件不感興趣,可以篩選回應,只提供 PresenceRecord 的一部分。
注意:
傳回的資料受到隱私權和內容隔離規則的限制。

URI 參數

| 參數| 類型| 描述| | --- | --- | --- | --- | | xuid| 64 位元不帶正負號的整數| 目標使用者的 XBOX 使用者識別碼 (XUID)。|

查詢字串參數

| 參數| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | | level| 字串| 選用。
  • user:僅傳回使用者節點。
  • device:傳回使用者節點和裝置節點。
  • title:預設值。傳回活動以外的整個樹狀結構。
  • all:傳回整個樹狀結構,包括活動層級的狀態。
|

授權

| 類型| 必要| 描述| 遺漏時的回應| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XUID| 是| 呼叫者的 XBOX 使用者識別碼 (XUID)| 403 Forbidden|

隱私權設定對資源的影響

此方法一律傳回 200 OK,但回應本文中可能不會傳回內容。 | 提出要求的使用者| 目標使用者的隱私權設定| 行為| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 我| -| 200 OK| | 朋友| 所有人| 200 OK| | 朋友| 僅限朋友| 200 OK| | 朋友| 已封鎖| 200 OK| | 非朋友使用者| 所有人| 200 OK| | 非朋友使用者| 僅限朋友| 200 OK| | 非朋友使用者| 已封鎖| 200 OK| | 協力廠商網站| 所有人| 200 OK| | 協力廠商網站| 僅限朋友| 200 OK| | 協力廠商網站| 已封鎖| 200 OK|

必要的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| 字串| HTTP 驗證的驗證認證。範例值:“XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| 字串| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後,要求才會路由至該服務。範例值:3、vnext。| | Accept| 字串| 可接受的 Content-Type。Presence 唯一支援的是 application/json,但必須在標頭中指定。| | Accept-Language| 字串| 回應中字串可接受的地區設定。範例值:en-US。| | Host| 字串| 伺服器的網域名稱。範例值:presencebeta.xboxlive.com。|

選用的要求標頭

| 標頭| 類型| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後,要求才會路由至該服務。預設值:1。|

要求本文

此要求的本文中不會傳送任何物件。

回應本文

範例回應

如果使用者沒有現有的記錄,則會傳回沒有裝置的記錄。

另請參閱

上層
/users/xuid()
Last modified on October 6, 2026