Skip to main content

GET (/users//people/avoid)

获取用户的回避列表。

备注

如果指定了目标,则仅当该用户在阻止列表中时才返回该用户;否则若该用户不在列表中则返回空。

URI 参数

授权

使用的授权声明 | 声明 | 类型 | 是否必需? | 示例值 | | --- | --- | --- | --- | --- | --- | --- | | Xuid | 64 位有符号整数 | 是 | 1234567890 |

必需的请求标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization | string | HTTP 身份验证的身份验证凭据。示例值:Xauth=<authtoken>。最大大小:无。 | | Accept | string | 可接受的 Content-Type。示例值:application/json。最大大小:无。 |

HTTP 状态代码

服务针对使用此方法对此资源发出的请求,返回本节中的一个状态代码。有关 XBOX Live 服务使用的标准 HTTP 状态代码的完整列表,请参阅标准 HTTP 状态代码。 | 代码 | 原因短语 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 200 | OK | 已成功检索会话。 | | 400 | Bad Request | URI 中指定的目标 ID 无效。 | | 403 | Forbidden | URI 中指定的所有者不是经过身份验证的用户。 | | 404 | Not Found | URI 中指定的所有者不存在。 |

必需的响应标头

| 标头 | 类型 | 说明 | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Content-Type | string | 请求正文的 MIME 类型。示例值:application/json。最大大小:无。 | | Content-Length | string | 响应中发送的字节数。示例值:34。最大大小:无。 | | Cache-Control | string | 服务器发出的用于指定缓存行为的礼貌请求。示例值:application/json。最大大小:无。 |

响应正文

示例响应

另请参阅

父主题
/users//people/avoid
Last modified on October 19, 2026