DELETE /v1/identity/session-families/{family_id}
撤销当前用户的一个设备会话族
说明（契约原文）
目标必须属于当前已认证 principal 的同一 scope/user。服务端在同一事务中重新锁定并校验 caller session、账户、membership 和 scope 后锁定整个 family。原 caller 仍有效时，精确重试 返回原响应；相同 Idempotency-Key 改变 family、revision、caller 或 request identity 返回 409。 撤销当前会话时，本次响应成功后当前 Bearer token 立即失效，后续请求先返回 401，不能绕过 caller 认证读取幂等收据。
参数
| 名称 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
family_id | path | string(uuid) | 是 | — |
X-Request-ID | header | string(uuid) | 是 | — |
If-Match | header | string | 是 | 列表返回的当前 family revision，必须使用强 ETag 形式 |
Idempotency-Key | header | string | 是 | — |
响应
| 状态码 | 说明 |
|---|---|
200 | 已撤销或精确幂等重放 字段： |
400 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
401 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
404 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
405 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
409 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
500 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
503 | 稳定错误码和默认中文消息；不包含服务端原始错误或敏感会话数据 |
失败时怎么办
400按字段说明修正参数或请求体再发；不要原样重试。401检查凭据格式、是否过期或被轮换。404资源不存在或不属于当前租户。409先回读资源当前状态；同一操作重试保持原 Idempotency-Key 和原请求内容。500结果未知：先按资源 ID 或列表回读确认，再决定是否用原 Idempotency-Key 重试。503依赖暂不可用：稍后用原 Idempotency-Key 重试。