{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "无状态会员限额校验（场景D）",
    "method": "POST",
    "path": "/openapi/stateless-members/limitCheck",
    "description": "场景D：在场景C（功能模块校验）的基础上，进一步校验当前功能模块的使用量是否已达到配置的上限（limitValue）。适用于有次数或存储上限控制的业务场景。",
    "requestParams": {
      "headers": [
        {
          "name": "X-Member-Key",
          "type": "string",
          "required": true,
          "description": "会员密钥令牌（混合JWT加密）"
        },
        {
          "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": "功能模块代码（moduleCode），如 VIDEO_DOWNLOAD"
        }
      ],
      "body": {
        "currentCount": "number｜必填，当前已使用次数/数量（由第三方系统维护），如 8"
      }
    },
    "responseExamples": {
      "校验通过（有限额）": {
        "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
          },
          "system": {
            "code": "system-b",
            "name": "系统B"
          },
          "function": {
            "code": "VIDEO_DOWNLOAD",
            "name": "视频下载"
          },
          "limit": {
            "value": 10,
            "current": 8,
            "remaining": 2
          }
        }
      },
      "校验通过（无限额）": {
        "code": "0000",
        "message": "校验通过",
        "data": {
          "valid": true,
          "remainingDays": 25,
          "limit": null
        }
      },
      "已达使用上限": {
        "code": "1010",
        "message": "当前功能使用已达上限（10）",
        "data": {
          "limitValue": 10,
          "currentCount": 10
        }
      },
      "会员不支持该功能": {
        "code": "1508",
        "message": "当前会员不支持当前功能",
        "data": null
      },
      "会员类型未授权系统": {
        "code": "1007",
        "message": "会员类型未授权当前系统",
        "data": null
      }
    },
    "notes": [
      "limit 字段为 null 表示该功能未配置限额，即不限次数",
      "limit.remaining = limit.value - currentCount，小于等于0时拒绝",
      "currentCount 由第三方系统自行维护并传入，本系统不做存储",
      "限额配置在管理后台 会员功能限制（memberFunctionLimits）中设置"
    ]
  }
}