{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "无状态会员有效性校验（场景A）",
    "method": "POST",
    "path": "/openapi/stateless-members/valid-check",
    "description": "场景A：仅校验无状态会员是否有效（未过期），不校验会员类型与系统的支持关系。适用于第三方只需确认会员是否开通且未到期的简单场景。",
    "requestParams": {
      "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": "系统编码（用于路由到正确数据库，本接口不校验系统-会员类型兼容性）"
        }
      ]
    },
    "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
          }
        }
      },
      "会员已过期": {
        "code": "1005",
        "message": "会员已过期",
        "data": null
      },
      "密钥需重新绑定": {
        "code": "1505",
        "message": "传入的会员需要重新绑定",
        "data": null
      },
      "会员码无效": {
        "code": "1504",
        "message": "您绑定的会员码无效",
        "data": null
      }
    },
    "notes": [
      "X-Member-Key 为激活接口返回的 keyToken（混合JWT），到期后需重新调用 /activate 接口",
      "本接口不校验系统支持关系，适合场景A（只验有效性）",
      "场景B（验系统支持）请使用 /stateless-members/check",
      "场景C（验功能模块）请使用 /stateless-members/functionCheck",
      "场景D（验功能限额）请使用 /stateless-members/limitCheck"
    ]
  }
}