{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "有状态会员有效性校验（场景A）",
    "method": "POST",
    "path": "/openapi/memberships/valid-check",
    "description": "场景A：校验已登录用户的会员是否有效（未过期），不校验系统支持。适用于第三方已持有用户登录令牌，只需确认该用户是否有效会员的场景。",
    "requestParams": {
      "headers": [
        {
          "name": "Authorization",
          "type": "string",
          "required": true,
          "description": "用户登录令牌，格式 Bearer TOKEN（通过 /memberships/login 获取）"
        },
        {
          "name": "X-Site",
          "type": "string",
          "required": true,
          "description": "站点标识"
        },
        {
          "name": "X-System-Code",
          "type": "string",
          "required": true,
          "description": "系统编码（用于路由到正确数据库）"
        }
      ]
    },
    "responseExamples": {
      "校验通过": {
        "code": "0000",
        "message": "会员有效",
        "data": {
          "valid": true,
          "remainingDays": 20,
          "memberType": {
            "id": "xxx",
            "name": "黄金会员",
            "code": "H001"
          },
          "memberUser": {
            "id": "mu001",
            "code": "MU000001",
            "effectiveDate": "2026-03-01",
            "validityDays": 30
          },
          "user": {
            "id": "u001",
            "code": "CU000001",
            "phone": "138****8888",
            "name": "张三"
          }
        }
      },
      "未找到有效会员记录": {
        "code": "1503",
        "message": "未找到有效的会员记录",
        "data": null
      },
      "令牌无效": {
        "code": "1002",
        "message": "访问令牌无效或已过期",
        "data": null
      }
    },
    "notes": [
      "系统自动取该用户最新一条未过期的 memberUser 记录",
      "场景B（验系统支持）请使用 /memberships/check",
      "场景C（验功能模块）请使用 /memberships/functionCheck",
      "场景D（验功能限额）请使用 /memberships/limitCheck"
    ]
  }
}