> ## 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.

# POST (/users/{requestorId}/permission/validate)

> POST (/users/{requestorId}/permission/validate)

# POST (/users/{requestorId}/permission/validate)

取得一組是或否的答案，指出是否允許使用者對一組目標使用者執行指定的動作。

* [備註](#ID4EQ)
* [URI 參數](#ID4ECB)
* [授權](#ID4ENB)
* [必要的要求標頭](#ID4ESC)
* [要求本文](#ID4E4D)
* [HTTP 狀態碼](#ID4ETE)
* [必要的回應標頭](#ID4EIG)
* [回應本文](#ID4E5H)

<a id="ID4EQ" />

## 備註

要求本文會接受使用者清單和設定清單，結果則是每個使用者/設定組合的允許/封鎖結果。

在跨網路多人遊戲案例中 (必須在擁有 XBOX 使用者識別碼 (XUID) 的使用者與沒有 XUID 的網路外使用者之間執行隱私權通訊檢查)，請參閱 [PermissionCheckBatchRequest (JSON)](/zh-TW/reference/live/rest/json/json-permissioncheckbatchrequest) 以了解使用者類型。

<a id="ID4ECB" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| requestorId | 字串 | 必要。執行動作之使用者的識別碼。可能的值為 <code>xuid({xuid})</code> 和 <code>me</code>。必須是已登入的使用者。範例值：<code>xuid(0987654321)</code>。 |

<a id="ID4ENB" />

## 授權

使用的授權宣告 | 宣告| 類型| 必要？| 範例值|
\| --- | --- | --- | --- | --- | --- | --- |
\| Xuid| 64 位元帶正負號的整數| 是| 1234567890|

<a id="ID4ESC" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| 字串| HTTP 驗證的驗證認證。範例值：<code>XBL3.0 x=\<userhash>;\<token></code>|
\| X-RequestedServiceVersion| 字串| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。範例值：1。|

<a id="ID4E4D" />

## 要求本文

<a id="ID4EDE" />

### 必要成員

請參閱 [PermissionCheckBatchRequest (JSON)](/zh-TW/reference/live/rest/json/json-permissioncheckbatchrequest)。

```cpp theme={null}
{
    "users":
    [
        {"xuid":"12345"},
        {"xuid":"54321"}
    ],
    "permissions":
    [
        "ViewTargetGameHistory",
        "ViewTargetProfile"
    ]
}

```

<a id="ID4ETE" />

## HTTP 狀態碼

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

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 已成功擷取工作階段。|
\| 400| 要求無效。| 範例：不正確的設定識別碼、不正確的 URI 等。|
\| 404| URI 中指定的使用者不存在。| 找不到指定的資源。|

<a id="ID4EIG" />

## 必要的回應標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type| 字串| 要求本文的 MIME 類型。範例值：<code>application/json</code>|
\| Content-Length| 字串| 回應中傳送的位元組數目。範例值：34|
\| Cache-Control| 字串| 伺服器指定快取行為的禮貌性要求。範例：<code>no-cache, no-store</code>|

<a id="ID4E5H" />

## 回應本文

請參閱 [PermissionCheckBatchResponse (JSON)](/zh-TW/reference/live/rest/json/json-permissioncheckbatchresponse)。

<a id="ID4ELAAC" />

### 範例回應

```cpp theme={null}
{
    "responses":
    [
        {
            "user": {"xuid":"12345"},
            "permissions":
            [
                {
                    "isAllowed":true
                },
                {
                    "isAllowed":true
                }
            ]
        },
        {
            "user": {"xuid":"54321"},
            "permissions":
            [
                {
                    "isAllowed":false,
                    "reasons":
                    [
                        {"reason":"NotAllowed"}
                    ]
                },
                {
                    "isAllowed":false,
                    "reasons":
                    [
                        {"reason":"PrivilegeRest", "restrictedSetting":"AllowProfileViewing"}
                    ]
                }
            ]
        }
    ]
}

```

<a id="ID4EVAAC" />

## 另請參閱

<a id="ID4EXAAC" />

##### 上層

[/users/{requestorId}/permission/validate](/zh-TW/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate)

[PermissionId 列舉](/zh-TW/reference/live/rest/enums/privacy-enum-permissionid)


## Related topics

- [PermissionId Enumeration](/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeração PermissionId](/pt-BR/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Enumeración PermissionId](/es/reference/live/rest/enums/privacy-enum-permissionid.md)
- [Énumération PermissionId](/fr/reference/live/rest/enums/privacy-enum-permissionid.md)
- [PermissionId 枚举](/zh-CN/reference/live/rest/enums/privacy-enum-permissionid.md)