{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "登录令牌校验",
    "method": "POST",
    "path": "/openapi/memberships/login/verify",
    "description": "对登录接口返回的访问令牌进行有效性校验，确认令牌是否过期、账号状态及黑名单状态。校验成功时 data 同时返回 scopeKeys 与 defaultScopeKey，与登录接口一致，便于外部系统在仅持有令牌时获取数据分区信息。",
    "requestParams": {
      "headers": [
        {
          "name": "Authorization",
          "type": "string",
          "required": true,
          "description": "登录接口返回的访问令牌，格式为 Bearer TOKEN"
        },
        {
          "name": "X-System-Code",
          "type": "string",
          "required": true,
          "description": "系统编码。用于指定当前登录的业务系统（例如 AUTH_MANAGEMENT、CONTENT_MANAGEMENT）。当系统不支持时将返回“登录用户不支持当前系统，可联系管理员处理”。"
        }
      ]
    },
    "responseExample": {
      "success": {
        "code": "0000",
        "message": "登录令牌校验成功",
        "data": {
          "phone": "13800138000",
          "id": "USER000001",
          "_id": "MNFIOHH6QOA3kg0z",
          "scopeKeys": [
            {
              "key": "550e8400-e29b-41d4-a716-446655440001",
              "type": "personal",
              "label": "个人"
            },
            {
              "key": "550e8400-e29b-41d4-a716-446655440002",
              "type": "organization",
              "organizationId": 1,
              "label": "示例公司"
            }
          ],
          "defaultScopeKey": "550e8400-e29b-41d4-a716-446655440002"
        }
      },
      "failure": {
        "code": "1300",
        "message": "登录令牌无效或已过期",
        "data": null
      }
    },
    "notes": [
      "当令牌失效、对应账号被禁用或存在黑名单记录时也会返回 200，但 code 与 message 表示具体失败原因。",
      "成功时 data.scopeKeys 与 data.defaultScopeKey 与 memberships/login 登录成功响应一致，均为明文 UUID。",
      "支持通过 X-Site header 切换站点，切换后使用对应站点的数据库进行权限校验。"
    ]
  }
}