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直接调用。