> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/xuid({xuid})/scids/{scid}/stats)

> GET (/users/xuid({xuid})/scids/{scid}/stats)

# GET (/users/xuid({xuid})/scids/{scid}/stats)

代表指定的使用者，取得以逗號分隔的使用者統計資料名稱清單為範圍的服務設定。
這些 URI 的網域為 `userstats.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4EEB)
* [查詢字串參數](#ID4EPB)
* [授權](#ID4EUC)
* [必要的要求標頭](#ID4EPD)
* [選用的要求標頭](#ID4EYE)
* [要求本文](#ID4E3F)
* [HTTP 狀態碼](#ID4EHG)
* [回應本文](#ID4E5BAC)

<a id="ID4EV" />

## 備註

用戶端需要一種方式，代表玩家將遊戲統計資料讀取和寫入我們的新玩家統計資料系統。

<a id="ID4EEB" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| xuid | GUID | 代表其存取服務設定之使用者的 XBOX 使用者識別碼 (XUID)。 |
| scid | GUID | 包含所存取資源之服務設定的識別碼。 |

<a id="ID4EPB" />

## 查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| statNames| string| 唯一的查詢字串參數是以逗號分隔的使用者統計資料名稱 URI 名詞。例如，下列 URI 會通知服務，代表 URI 中指定的使用者識別碼要求四項統計資料。`https://userstats.xboxlive.com/users/xuid({xuid})/scids/{scid}/stats/wins,kills,kdratio,headshots`單一呼叫中可要求的統計資料數目會有限制，而該限制會仔細考量開發人員便利性與 URI 長度實用性之間的「最佳平衡點」。例如，限制可能取決於 600 個字元的統計資料名稱文字 (包括逗號)，或最多 10 項統計資料。啟用像這樣的簡單 GET，可以為經常要求的統計資料啟用 HTTP 快取，進而減少頻繁呼叫之用戶端的呼叫量。 |

<a id="ID4EUC" />

## 授權

針對內容隔離和存取控制案例，已實作授權邏輯。

* 只要呼叫端隨要求提交有效的 XSTS 權杖，任何平台上的用戶端都可以讀取排行榜和使用者統計資料。寫入作業顯然僅限於 Player Data 系統支援的用戶端。
* 遊戲開發人員可以使用 Partner Center 將統計資料標示為開放或受限制。排行榜是開放的統計資料。只要使用者已獲授權存取沙箱，Smartglass 以及 iOS、Android、Windows、Windows Phone 和 Web 應用程式就可以存取開放的統計資料。使用者對沙箱的授權是透過 Partner Center 管理。

檢查的虛擬程式碼如下所示：

```cpp theme={null}
If (!checkAccess(serviceConfigId, resource, CLAIM[userid, deviceid, titleid]))
{
        Reject request as Unauthorized
}

// else accept request.

```

<a id="ID4EPD" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 驗證的驗證認證。範例值："XBL3.0 x=\<userhash>;\<token>"。|

<a id="ID4EYE" />

## 選用的要求標頭

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

<a id="ID4E3F" />

## 要求本文

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

<a id="ID4EHG" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應在此資源上使用此方法所提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)。

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 已成功擷取工作階段。|
\| 304| Not Modified| 自上次要求後資源未曾修改。|
\| 400| Bad Request| 服務無法理解格式錯誤的要求。通常是無效的參數。|
\| 401| Unauthorized| 要求需要使用者驗證。|
\| 403| Forbidden| 不允許使用者或服務提出此要求。|
\| 404| Not Found| 找不到指定的資源。|
\| 406| Not Acceptable| 不支援資源版本。|
\| 408| Request Timeout| 不支援資源版本；應由 MVC 層拒絕。|

<a id="ID4E5BAC" />

## 回應本文

<a id="ID4EECAC" />

### 範例回應

```cpp theme={null}
{
    "user": {
    "xuid": "123456789",
        "gamertag": "WarriorSaint",
        "stats": [
            {
                "statname": "Wins",
                "type": "Integer",
                "value": 40
            },
            {
                "statname": "Kills",
                "type": "Integer",
                "value": 700
            },
            {
                "statname": "KDRatio",
                "type": "Double",
                "value": 2.23
            },
            {
                "statname": "Headshots",
                "type": "Integer",
                "value": 173
            }
        ],
    }
}

```

<a id="ID4EOCAC" />

## 另請參閱

<a id="ID4EQCAC" />

##### 上層

[/users/xuid({xuid})/scids/{scid}/stats](/zh-TW/reference/live/rest/uri/userstats/uri-usersxuidscidsscidstats)


## Related topics

- [Event-based Leaderboards overview](/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [Visão geral dos leaderboards baseados em eventos](/pt-BR/services/xbox-services/player-data/stats-leaderboards/event-based/live-leaderboards-eb-overview.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](/fr-CA/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)
- [XblUserStatisticsGetSingleUserStatisticsAsync](/fr-CA/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)