# OpenAPI 接口 - 有状态会员有效性校验（场景A）

> 模块标识：openapi  |  接口数量：66

## 接口说明
**方法**：	POST

**路径**：				/openapi/memberships/valid-check

**功能说明**：
场景A：校验已登录用户的会员是否有效（未过期），不校验系统支持。适用于第三方已持有用户登录令牌，只需确认该用户是否有效会员的场景。

### 请求参数
```json
{
  "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": "系统编码（用于路由到正确数据库）"
    }
  ]
}
```

### 响应示例

#### 校验通过

```json
{
  "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": "张三"
    }
  }
}
```

#### 未找到有效会员记录

```json
{
  "code": "1503",
  "message": "未找到有效的会员记录",
  "data": null
}
```

#### 令牌无效

```json
{
  "code": "1002",
  "message": "访问令牌无效或已过期",
  "data": null
}
```

### 注意事项
- 系统自动取该用户最新一条未过期的 memberUser 记录
- 场景B（验系统支持）请使用 /memberships/check
- 场景C（验功能模块）请使用 /memberships/functionCheck
- 场景D（验功能限额）请使用 /memberships/limitCheck