🏮 SaaS授权系统

API使用文档与集成指南

📋 目录

🎯 系统概述

SaaS授权系统是一个基于云端的授权验证平台，支持一机一码和一次性激活两种授权模式，适用于软件、网站、应用等多种场景的授权管理。

核心特性

  • 一机一码验证：绑定设备指纹，防止多设备共享
  • 一次性激活码：支持时限控制，适用于临时授权
  • 多级会员系统：体验、VIP、终身等不同权限等级
  • 云端验证：实时验证，防止离线破解
  • API密钥保护：防止未授权API调用
  • 中国风界面：传统美学与现代技术的完美结合
🚀 快速开始
1. 获取API密钥：saas-api-secure-key-2024
2. 生成卡密：在管理面板中创建卡密
3. 集成验证：在您的应用中调用验证API
4. 享受安全：云端验证，实时保护

👥 会员系统说明

会员等级 有效期 设备限制 功能权限 适用场景
体验会员 7天 1台设备 基础功能 免费试用、功能体验
VIP会员 30天 2台设备 基础+高级功能 付费用户、短期订阅
终身会员 永久 5台设备 全部功能 一次性付费、长期用户

会员权限说明

  • 基础功能：核心授权验证、基本API调用
  • 高级功能：批量操作、数据导出、高级统计
  • 全部功能：所有功能 + 优先技术支持

🎫 卡密类型详解

一机一码

推荐用于：软件授权、防盗版、会员系统
  • 工作原理：通过设备指纹绑定，确保一个卡密只能在一台设备上使用
  • 设备指纹：包含硬件信息、系统信息、浏览器特征等
  • 安全性：高，有效防止账号共享
  • 适用场景：
    • 桌面软件授权
    • 专业工具许可
    • 游戏账号绑定
    • 企业软件管理

一次性激活码

推荐用于：临时授权、内容解锁、限时活动
  • 工作原理：激活后立即失效，支持时间限制
  • 时间控制：可设置有效期，过期自动失效
  • 灵活性：高，支持各种时长配置
  • 适用场景：
    • 网站会员激活
    • 内容付费解锁
    • 限时促销活动
    • 临时访问权限

🔌 API接口文档

基础信息

  • API地址：https://saas-card-api.huanghuanshds.workers.dev
  • 请求方式：POST
  • 内容类型：application/json
  • 字符编码：UTF-8

卡密验证接口

POST /verify Content-Type: application/json { "card_key": "卡密字符串", "device_fingerprint": "设备指纹", "device_info": { "user_agent": "浏览器信息", "screen": "屏幕分辨率", "timezone": "时区信息" }, "api_key": "saas-api-secure-key-2024" }

响应格式

成功响应

{ "success": true, "data": { "user_id": "用户ID", "membership_level": { "name": "会员等级名称", "features": ["功能列表"] }, "expires_at": "过期时间", "message": "验证成功" } }

失败响应

{ "success": false, "error": "错误信息" }

错误代码说明

错误信息 说明 解决方案
卡密不能为空 未提供卡密参数 检查请求参数
API密钥无效 API密钥错误或缺失 使用正确的API密钥
卡密不存在或已被禁用 卡密无效 检查卡密是否正确
卡密已被使用 一次性卡密已激活 使用新的卡密