SDK 下载

# SDK 下载 Vastark 行为验证码提供多语言 SDK,方便各技术栈快速集成。 ## Go SDK Go SDK 已正式发布,支持 Go 1.12+ 版本。 - 仓库地址:[https://gitee.com/vastark/sdk-go](https://gitee.com/vastark/sdk-go) ## Python SDK 支持Python 3.0+ 版本。 - 仓库地址:[https://gitee.com/vastark/sdk-python](https://gitee.com/vastark/sdk-python) ## PHP SDK 支持PHP 7.0+ 版本。 - 仓库地址:[https://gitee.com/vastark/sdk-php](https://gitee.com/vastark/sdk-php) ## Java SDK 支持Java 8.0+ 版本。 - 仓库地址:[https://gitee.com/vastark/sdk-java](https://gitee.com/vastark/sdk-java) ## Javascript SDK (H5端使用) 为浏览器端行为验证码(图形点击验证)提供即插即用的前端集成方案。 - 仓库地址:[https://gitee.com/vastark/recaptcha-js-sdk](https://gitee.com/vastark/recaptcha-js-sdk) - 引入方式:支持 ESM(`import`)和 UMD(`<script>` 标签)两种方式 - 文档地址:仓库内 `README.md` 包含完整的 API 参考、配置参数、自定义样式和响应式适配指南 ### 核心能力 | 能力 | 说明 | |------|------| | 图形点击验证 | 用户按顺序点击图片中文字,SDK 自动处理坐标采集与服务端校验 | | 设备指纹 | 自动采集浏览器信号(UA、屏幕、时区等)并哈希生成设备指纹,支持手动传入 | | 故障降级 | 支持 `fail-open`(服务异常时放行)和 `fail-close`(服务异常时阻断)两种策略 | | 样式自定义 | 支持 `styleText` 配置注入自定义 CSS,覆盖按钮、边框、提示文字等全部视觉元素 | | 移动端适配 | 同时支持鼠标点击和触摸事件,容器宽度自适应 200px~320px | | 票据自动刷新 | 验证票据过期或无效时 SDK 自动刷新验证码,无需业务侧干预 | ### 常见问题 **Q: JS SDK 支持哪些前端框架?** A: JS SDK 提供 ESM 和 UMD 两种构建产物,不依赖任何框架。可直接在 Vue、React、Angular 等现代前端工程中 `import` 使用,也可通过 `<script>` 标签在传统页面或 jQuery 项目中引入。SDK 只操作你指定的 DOM 容器,不会与框架的路由或状态管理冲突。 **Q: 验证码容器的 CSS 有什么特殊要求?** A: 验证码容器在展示时必须保持可见(不能 `display: none`),因为 SDK 通过 `getBoundingClientRect()` 计算图片点击坐标。容器宽度决定请求的验证码图片尺寸(200px~320px),建议容器内容区宽度至少 200px,移动端使用 `max-width: 100%` 铺满屏幕。详见仓库 README 中的「容器约束」和「响应式容器 CSS 设置指南」章节。 **Q: 如何自定义验证码按钮和边框的样式?** A: 通过 `createCaptchaClient({ styleText: '...' })` 初始化时注入,或运行时调用 `captcha.setStyleText('...')` 动态替换。SDK 暴露了 `.saassdk-secure-captcha-verify-btn`、`.saassdk-secure-captcha-refresh-btn`、`.saassdk-secure-captcha-image-container` 等 10 个 CSS 类名,覆盖按钮、图片边框、提示文字、点击标记等全部视觉元素。也可以通过 `useDefaultStyles: false` 完全关闭默认样式。 **Q: 移动端点击验证码会不准吗?** A: 不会。SDK 同时处理桌面端 `click` 事件(通过 `offsetX/offsetY`)和移动端 `touchend` 事件(通过 `clientX/clientY` + 图片边界框回退计算),坐标映射逻辑会自动区分事件类型并使用正确的计算方法。需要确保页面有 `<meta name="viewport" content="width=device-width, initial-scale=1.0">`。 **Q: 用户验证失败后,SDK 会自动刷新验证码吗?** A: 部分场景会自动处理。当服务端返回验证票据过期或无效(`E_VERIFY_TICKET_INVALID`)时,SDK 会自动调用 `refresh()` 刷新验证码,用户无需手动操作。如果是因为被临时封禁(`E_BANNED`)或跨域未配置(`E_CORS_BLOCKED`),SDK 会通过 `onError` 回调通知业务侧,需自行处理提示。 > 更多语言 SDK 将陆续发布,如需特定语言支持,请联系平台,也可自行根据RESTFUL API直接调用。