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

ユーザーが対象ユーザーのセットに対して指定されたアクションを実行できるかどうかを、yes または no の回答セットで取得します。

* [備考](#ID4EQ)
* [URI パラメーター](#ID4ECB)
* [認可](#ID4ENB)
* [必須リクエスト ヘッダー](#ID4ESC)
* [リクエスト本文](#ID4E4D)
* [HTTP ステータス コード](#ID4ETE)
* [必須レスポンス ヘッダー](#ID4EIG)
* [レスポンス本文](#ID4E5H)

## 備考

リクエスト本文にはユーザーのリストと設定のリストを指定し、その結果は各ユーザー/設定のペアに対する allowed/blocked の結果です。

クロス ネットワーク マルチプレイヤー シナリオ (XBOX User ID (XUID) を持つユーザーと XUID を持たないネットワーク外のユーザー間でプライバシー コミュニケーション チェックを実行する必要がある場合) では、User タイプについて「[PermissionCheckBatchRequest (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-permissioncheckbatchrequest)」を参照してください。

## URI パラメーター

| Parameter | Type | Description |
| - | - | - |
| requestorId | string | 必須。アクションを実行するユーザーの識別子。指定可能な値は `xuid()` および `me` です。ログイン済みのユーザーである必要があります。値の例: `xuid(0987654321)`。 |

## 認可

使用される認可クレーム | Claim| Type| Required?| Example value|
\| --- | --- | --- | --- | --- | --- | --- |
\| Xuid| 64-bit signed integer| yes| 1234567890|

## 必須リクエスト ヘッダー

\| Header| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| string| HTTP 認証用の認証資格情報。値の例: `XBL3.0 x=<userhash>;<token>`|
\| X-RequestedServiceVersion| string| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 1。|

## リクエスト本文

### 必須メンバー

「[PermissionCheckBatchRequest (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-permissioncheckbatchrequest)」を参照してください。

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

```

## HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「[標準 HTTP ステータス コード](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes)」を参照してください。

\| Code| Reason phrase| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| セッションが正常に取得されました。|
\| 400| リクエストが無効です。| 例: 不正な設定 ID、不正な URI など。|
\| 404| URI で指定されたユーザーは存在しません。| 指定されたリソースが見つかりませんでした。|

## 必須レスポンス ヘッダー

\| Header| Type| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type| string| リクエスト本文の MIME タイプ。値の例: `application/json`|
\| Content-Length| string| レスポンスで送信されるバイト数。値の例: 34|
\| Cache-Control| string| キャッシュ動作を指定するサーバーからの丁重な要求。例: `no-cache, no-store`|

## レスポンス本文

「[PermissionCheckBatchResponse (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-permissioncheckbatchresponse)」を参照してください。

### レスポンス例

```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"}
                    ]
                }
            ]
        }
    ]
}

```

## 関連項目

##### 親

[/users/{requestorId}/permission/validate](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/privacy/uri-privacyusersrequestoridpermissionvalidate)

[PermissionId 列挙型](https://devdocs.xbox.com/ja-jp/reference/live/rest/enums/privacy-enum-permissionid.md)


## Related topics

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