reCAPTCHA 项目技术文档
1. 安装指南
1.1 获取 API 密钥
首先,访问 reCAPTCHA 管理控制台 获取 reCAPTCHA API 密钥。根据你的需求选择 reCAPTCHA 类型(v2 Checkbox、v2 Invisible 或 v3),并生成相应的密钥。
1.2 配置环境变量
在开发环境中,你可以使用环境变量来存储 API 密钥。例如,使用 dotenv
gem 来管理环境变量:
export RECAPTCHA_SITE_KEY = '6Lc6BAAAAAAAAChqRbQZcn_yyyyyyyyyyyyyyyyy'
export RECAPTCHA_SECRET_KEY = '6Lc6BAAAAAAAAKN3DRm6VA_xxxxxxxxxxxxxxxxx'
如果你使用的是企业版 API 密钥,还需要设置以下环境变量:
export RECAPTCHA_ENTERPRISE = 'true'
export RECAPTCHA_ENTERPRISE_API_KEY = 'AIzvFyE3TU-g4K_Kozr9F1smEzZSGBVOfLKyupA'
export RECAPTCHA_ENTERPRISE_PROJECT_ID = 'my-project'
2. 项目安装方式
2.1 Rails 安装
在 Rails 项目中,首先在 Gemfile
中添加 recaptcha
gem:
gem "recaptcha"
然后运行 bundle install
安装 gem。
2.2 Sinatra / Rack / Ruby 安装
在 Sinatra 或 Rack 项目中,同样需要在 Gemfile
中添加 recaptcha
gem:
gem 'recaptcha'
然后设置环境变量,并在需要的地方包含 Recaptcha::Adapters::ViewMethods
和 Recaptcha::Adapters::ControllerMethods
。
3. 项目的使用说明
3.1 在视图中嵌入 reCAPTCHA
在需要保护的表单中,使用 recaptcha_tags
方法嵌入 reCAPTCHA:
<%= form_for @foo do |f| %>
# …
<%= recaptcha_tags %>
# …
<% end %>
3.2 在控制器中验证 reCAPTCHA
在表单提交的控制器中,使用 verify_recaptcha
方法验证 reCAPTCHA 响应:
# app/controllers/users_controller.rb
@user = User.new(params[:user].permit(:name))
if verify_recaptcha(model: @user) && @user.save
redirect_to @user
else
render 'new'
end
4. 项目 API 使用文档
4.1 reCAPTCHA V2 API 使用
recaptcha_tags
当你的 reCAPTCHA 类型为 "v2 Checkbox" 时,使用此方法。
可用选项:
:theme
:指定主题,可选值为dark
或light
(默认:light
)。:ajax
:渲染动态 AJAX reCAPTCHA(默认:false
)。:site_key
:覆盖配置中的站点 API 密钥。:error
:覆盖 reCAPTCHA API 返回的错误代码(默认:nil
)。:size
:指定大小(默认:nil
)。:nonce
:可选。为脚本设置 nonce 属性(默认:nil
)。:id
:指定 HTML id 属性(默认:nil
)。:callback
:可选。成功回调函数的名称。:expired_callback
:可选。过期回调函数的名称。:error_callback
:可选。错误回调函数的名称。:noscript
:包含<noscript>
内容(默认:true
)。
verify_recaptcha
此方法返回 true
或 false
,用于处理 reCAPTCHA 小部件的响应令牌。通常在控制器中调用。
可用选项:
:model
:设置错误的模型。:attribute
:模型属性接收错误(默认::base
)。:message
:自定义错误消息。:secret_key
:覆盖配置中的密钥 API 密钥。:enterprise_api_key
:覆盖企业 API 密钥。:enterprise_project_id
:覆盖企业项目 ID。:timeout
:等待 reCAPTCHA 服务器的秒数(默认:3
)。:response
:自定义响应参数(默认:params['g-recaptcha-response-data']
)。
4.2 reCAPTCHA V3 API 使用
recaptcha_v3
当你的 reCAPTCHA 类型为 "v3" 时,使用此方法。
verify_recaptcha
(用于 v3)
与 v2 类似,但用于验证 v3 的响应。
recaptcha_reply
获取 reCAPTCHA 响应的详细信息。
5. 国际化支持
reCAPTCHA 支持多语言,可以通过 :hl
选项指定语言代码。
6. 测试
在测试环境中,可以通过设置 RECAPTCHA_TESTING
环境变量为 true
来跳过 reCAPTCHA 验证。
7. 其他 API 密钥设置
除了环境变量,还可以通过其他方式配置或覆盖 API 密钥,具体参考项目的 Alternative API Key Setup 部分。
- DDeepSeek-V3.1-BaseDeepSeek-V3.1 是一款支持思考模式与非思考模式的混合模型Python00
- QQwen-Image-Edit基于200亿参数Qwen-Image构建,Qwen-Image-Edit实现精准文本渲染与图像编辑,融合语义与外观控制能力Jinja00
GitCode-文心大模型-智源研究院AI应用开发大赛
GitCode&文心大模型&智源研究院强强联合,发起的AI应用开发大赛;总奖池8W,单人最高可得价值3W奖励。快来参加吧~044CommonUtilLibrary
快速开发工具类收集,史上最全的开发工具类,欢迎Follow、Fork、StarJava04GitCode百大开源项目
GitCode百大计划旨在表彰GitCode平台上积极推动项目社区化,拥有广泛影响力的G-Star项目,入选项目不仅代表了GitCode开源生态的蓬勃发展,也反映了当下开源行业的发展趋势。06GOT-OCR-2.0-hf
阶跃星辰StepFun推出的GOT-OCR-2.0-hf是一款强大的多语言OCR开源模型,支持从普通文档到复杂场景的文字识别。它能精准处理表格、图表、数学公式、几何图形甚至乐谱等特殊内容,输出结果可通过第三方工具渲染成多种格式。模型支持1024×1024高分辨率输入,具备多页批量处理、动态分块识别和交互式区域选择等创新功能,用户可通过坐标或颜色指定识别区域。基于Apache 2.0协议开源,提供Hugging Face演示和完整代码,适用于学术研究到工业应用的广泛场景,为OCR领域带来突破性解决方案。00openHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!C0301- WWan2.2-S2V-14B【Wan2.2 全新发布|更强画质,更快生成】新一代视频生成模型 Wan2.2,创新采用MoE架构,实现电影级美学与复杂运动控制,支持720P高清文本/图像生成视频,消费级显卡即可流畅运行,性能达业界领先水平Python00
- GGLM-4.5-AirGLM-4.5 系列模型是专为智能体设计的基础模型。GLM-4.5拥有 3550 亿总参数量,其中 320 亿活跃参数;GLM-4.5-Air采用更紧凑的设计,拥有 1060 亿总参数量,其中 120 亿活跃参数。GLM-4.5模型统一了推理、编码和智能体能力,以满足智能体应用的复杂需求Jinja00
Yi-Coder
Yi Coder 编程模型,小而强大的编程助手HTML013
热门内容推荐
最新内容推荐
项目优选









