快速开始
集成 Captcha v4 的基本步骤
在开始之前，请确保您已经拥有 Geelab 账号并可以访问控制台。
前置要求
- Geelab 账号
- 控制台访问权限
- 确定集成平台（Web、Android、iOS 或服务端）
地域选择
重要： 开始集成前，请先了解如何选择合适的服务地域。查看 地域选择指南 了解详情。
根据您的用户位置选择对应的地域：
| 地域 | 适用场景 | 验证域名 | apiServers 参数值 |
|---|---|---|---|
| 🌏 全球 | 全球用户或亚太地区 | cap-global.geelabapi.com | cap-global.geelabapi.com |
| 🇪🇺 欧洲 | 欧盟用户（GDPR 合规） | cap-eu.geelabapi.com | cap-eu.geelabapi.com |
| 🇺🇸 北美 | 北美用户 | cap-na.geelabapi.com | cap-na.geelabapi.com |
apiServers 参数： 前端集成时必须配置 apiServers 参数，其值与您在控制台创建 ID 时选择的地域对应。
步骤 1：获取凭证
- 登录 Geelab 控制台
- 创建新的验证场景，选择合适的地域
- 获取您的
captcha_id和captcha_key
请妥善保管您的 captcha_key，不要在客户端代码中暴露。
步骤 2：客户端集成
选择您的平台并集成 SDK：
<!DOCTYPE html>
<html>
<head>
<script src="https://static.geelabapi.com/v4/gl4.js"></script>
</head>
<body>
<div id="captcha"></div>
<script>
initGeetest4({
captchaId: 'YOUR_CAPTCHA_ID',
product: 'bind',
apiServers: ['cap-global.geelabapi.com'] // 根据您选择的地域配置
}, function(captcha) {
captcha.appendTo('#captcha');
});
</script>
</body>
</html>记得将 YOUR_CAPTCHA_ID 替换为您在控制台获取的实际 ID，并根据创建 ID 时选择的地域配置 apiServers 参数。
查看 Android 集成指南 了解详细步骤。
查看 iOS 集成指南 了解详细步骤。
步骤 3：服务端验证
重要： 必须在服务端进行二次验证，确保安全性。
客户端验证成功后，将结果提交到您的服务器，然后调用 Geelab 验证 API。请根据您注册 ID 时选择的地域使用对应的域名：
- 全球：
https://cap-global.geelabapi.com/validate - 欧洲：
https://cap-eu.geelabapi.com/validate - 北美：
https://cap-na.geelabapi.com/validate
POST https://cap-global.geelabapi.com/validate?captcha_id=YOUR_CAPTCHA_ID
Content-Type: application/x-www-form-urlencoded
lot_number=xxx&captcha_output=xxx&pass_token=xxx&gen_time=xxx&sign_token=xxx完整的服务端验证实现请参考：
- 服务端集成指南 - 集成步骤和最佳实践
- Server API 文档 - 完整的 API 参数和代码示例
下一步
恭喜！您已经完成了基本集成。接下来可以：