Skip to main content

POST (/users//permission/validate)

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

備註

要求本文會接受使用者清單和設定清單,結果則是每個使用者/設定組合的允許/封鎖結果。 在跨網路多人遊戲案例中 (必須在擁有 XBOX 使用者識別碼 (XUID) 的使用者與沒有 XUID 的網路外使用者之間執行隱私權通訊檢查),請參閱 PermissionCheckBatchRequest (JSON) 以了解使用者類型。

URI 參數

授權

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

必要的要求標頭

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

要求本文

必要成員

請參閱 PermissionCheckBatchRequest (JSON)。

HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼,以回應使用此方法對此資源提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單,請參閱標準 HTTP 狀態碼。 | 代碼| 原因片語| 描述| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200| OK| 已成功擷取工作階段。| | 400| 要求無效。| 範例:不正確的設定識別碼、不正確的 URI 等。| | 404| URI 中指定的使用者不存在。| 找不到指定的資源。|

必要的回應標頭

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

回應本文

請參閱 PermissionCheckBatchResponse (JSON)。

範例回應

另請參閱

上層
/users//permission/validate PermissionId 列舉
Last modified on October 6, 2026