Skip to main content

GET (/users//permission/validate)

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

URI パラメーター

クエリ文字列パラメーター

| Parameter| Type| Description| | --- | --- | --- | --- | --- | --- | | setting| string enumeration| チェックする対象の PermissionId の値。値の例: “CommunicateUsingText”。| | target| string| アクションが実行される対象ユーザーの識別子。指定可能な値は xuid() です。値の例: 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。|

リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「標準 HTTP ステータス コード」を参照してください。 | 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|

レスポンス本文

「PermissionCheckResponse (JSON)」を参照してください。

レスポンス例

関連項目

親
/users//permission/validate PermissionId 列挙型
Last modified on October 19, 2026