# OpenAPI 接口 - 有状态会员限额校验（场景D）

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

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

**路径**：				/openapi/memberships/limitCheck

**功能说明**：
场景D：在场景C基础上，进一步校验当前功能模块的使用量是否已达配置上限。适用于有存储量/次数上限的业务，如最多保存10条数据。

### 请求参数
```json
{
  "headers": [
    {
      "name": "Authorization",
      "type": "string",
      "required": true,
      "description": "用户登录令牌，格式 Bearer TOKEN"
    },
    {
      "name": "X-Site",
      "type": "string",
      "required": true,
      "description": "站点标识"
    },
    {
      "name": "X-System-Code",
      "type": "string",
      "required": true,
      "description": "系统编码"
    },
    {
      "name": "X-Function",
      "type": "string",
      "required": true,
      "description": "功能模块代码"
    }
  ],
  "body": {
    "currentCount": "number｜必填，当前已使用次数/数量（由第三方系统维护）"
  }
}
```

### 响应示例

#### 校验通过（有限额）

```json
{
  "code": "0000",
  "message": "校验通过",
  "data": {
    "valid": true,
    "remainingDays": 20,
    "memberType": {
      "id": "xxx",
      "name": "钻石会员",
      "code": "D001"
    },
    "memberUser": {
      "id": "mu001",
      "code": "MU000001",
      "effectiveDate": "2026-03-01",
      "validityDays": 30
    },
    "user": {
      "id": "u001",
      "code": "CU000001",
      "phone": "138****8888",
      "name": "张三"
    },
    "system": {
      "code": "system-b",
      "name": "系统B"
    },
    "function": {
      "code": "DATA_SAVE",
      "name": "数据保存"
    },
    "limit": {
      "value": 10,
      "current": 8,
      "remaining": 2
    }
  }
}
```

#### 校验通过（无限额）

```json
{
  "code": "0000",
  "message": "校验通过",
  "data": {
    "valid": true,
    "limit": null
  }
}
```

#### 已达使用上限

```json
{
  "code": "1010",
  "message": "当前功能使用已达上限（10）",
  "data": {
    "limitValue": 10,
    "currentCount": 10
  }
}
```

### 注意事项
- limit 为 null 表示未配置限额，不限次数
- currentCount 由第三方系统传入，本系统不持久化使用记录
- 限额配置在管理后台「会员功能限制」中设置（memberFunctionLimits 表）