{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "有状态会员限额校验（场景D）",
    "method": "POST",
    "path": "/openapi/memberships/limitCheck",
    "description": "场景D：在场景C基础上，进一步校验当前功能模块的使用量是否已达配置上限。适用于有存储量/次数上限的业务，如最多保存10条数据。",
    "requestParams": {
      "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｜必填，当前已使用次数/数量（由第三方系统维护）"
      }
    },
    "responseExamples": {
      "校验通过（有限额）": {
        "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
          }
        }
      },
      "校验通过（无限额）": {
        "code": "0000",
        "message": "校验通过",
        "data": {
          "valid": true,
          "limit": null
        }
      },
      "已达使用上限": {
        "code": "1010",
        "message": "当前功能使用已达上限（10）",
        "data": {
          "limitValue": 10,
          "currentCount": 10
        }
      }
    },
    "notes": [
      "limit 为 null 表示未配置限额，不限次数",
      "currentCount 由第三方系统传入，本系统不持久化使用记录",
      "限额配置在管理后台「会员功能限制」中设置（memberFunctionLimits 表）"
    ]
  }
}