{
  "module": {
    "module": "OpenAPI 接口",
    "moduleKey": "openapi"
  },
  "api": {
    "title": "购买/占用无状态会员",
    "method": "POST",
    "path": "/openapi/stateless-members/purchase",
    "description": "将指定无状态会员标记为已售出（saleStatus=1），实现一卡一卖，防止同一卡密被二次购买。不校验、不记录激活状态；已售出卡密在有效期内仍可通过 activate/check 等接口无限次激活。",
    "requestParams": {
      "headers": [
        {
          "name": "X-Site",
          "type": "string",
          "required": true,
          "description": "站点标识"
        },
        {
          "name": "X-System-Code",
          "type": "string",
          "required": true,
          "description": "系统编码"
        }
      ],
      "body": {
        "id": "string｜可选，无状态会员 _id 或数字 id",
        "code": "string｜可选，无状态会员编码",
        "orderNo": "string｜可选，关联订单号，写入 soldOrderNo"
      }
    },
    "responseExample": {
      "success": {
        "code": "0000",
        "message": "购买成功",
        "data": {
          "id": "xxx",
          "code": "SM0001",
          "name": "无状态会员",
          "saleStatus": 1,
          "soldAt": "2025-01-15T10:00:00.000Z",
          "soldOrderNo": "ORD-20250115-0010"
        }
      },
      "failureNotFound": {
        "code": "1510",
        "message": "无状态会员不存在",
        "data": null
      },
      "failureDisabled": {
        "code": "1511",
        "message": "无状态会员未启用，不可购买",
        "data": null
      },
      "failureSold": {
        "code": "1512",
        "message": "该无状态会员已售出，不可重复购买",
        "data": null
      }
    },
    "notes": [
      "id 与 code 至少提供一个",
      "仅当 status=1 且 saleStatus=0（或未设置）时可购买",
      "购买成功后 saleStatus=1，同一卡不可再次调用本接口",
      "售卖状态不影响 /openapi/stateless-members/activate、/check 等激活校验接口",
      "管理端也可通过 PUT /api/stateless-members/{id}/sale-status 或订单 statelessMemberId + PAID/COMPLETED 标记已售"
    ]
  }
}