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

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

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

**路径**：				/openapi/stateless-members/valid-check

**功能说明**：
场景A：仅校验无状态会员是否有效（未过期），不校验会员类型与系统的支持关系。适用于第三方只需确认会员是否开通且未到期的简单场景。

### 请求参数
```json
{
  "headers": [
    {
      "name": "X-Member-Key",
      "type": "string",
      "required": true,
      "description": "会员密钥令牌（混合JWT加密，payload.data = secretKey）"
    },
    {
      "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": 25,
    "memberType": {
      "id": "xxx",
      "name": "黄金会员",
      "code": "H001"
    },
    "member": {
      "id": "yyy",
      "code": "SM000001",
      "name": "新人可享",
      "effectiveDate": "2026-03-01",
      "validityDays": 30
    }
  }
}
```

#### 会员已过期

```json
{
  "code": "1005",
  "message": "会员已过期",
  "data": null
}
```

#### 密钥需重新绑定

```json
{
  "code": "1505",
  "message": "传入的会员需要重新绑定",
  "data": null
}
```

#### 会员码无效

```json
{
  "code": "1504",
  "message": "您绑定的会员码无效",
  "data": null
}
```

### 注意事项
- X-Member-Key 为激活接口返回的 keyToken（混合JWT），到期后需重新调用 /activate 接口
- 本接口不校验系统支持关系，适合场景A（只验有效性）
- 场景B（验系统支持）请使用 /stateless-members/check
- 场景C（验功能模块）请使用 /stateless-members/functionCheck
- 场景D（验功能限额）请使用 /stateless-members/limitCheck