ruby-2captcha 1.1.6 → 1.2.0

data/examples/coordinates_example.rb

@@ -0,0 +1,12 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.coordinates({
+  image: 'path/to/captcha.jpg',
+  lang: 'en',
+  hint_image: 'path/to/hint.jpg',
+  hint_text: 'Connect the dots'
+})
+
+puts "Result: #{result.inspect}"

data/examples/cut_captcha_example.rb

@@ -0,0 +1,11 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.cutcaptcha({
+  misery_key: "a1488b66da00bf332a1488993a5443c79047e752",
+  api_key: "SAb83IIB",
+  pageurl: "https://example.cc/foo/bar.html"
+})
+
+puts "Result: #{result.inspect}"

data/examples/cyber_siara_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.cyber_siara({
+  pageurl: "https://test.com",
+  master_url_id: "12333-3123123"
+})
+
+puts "Result: #{result.inspect}"

data/examples/datadome_example.rb

@@ -0,0 +1,12 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.data_dome({
+  pageurl: "https://test.com",
+  captcha_url: "https://test.com/captcha/",
+  proxytype: "http",
+  proxy: "proxyuser:strongPassword@123.123.123.123:3128"
+})
+
+puts "Result: #{result.inspect}"

data/examples/drag_drop_example.rb

@@ -0,0 +1,24 @@
+require_relative "../lib/api_2captcha"
+
+client = Api2Captcha.new(ARGV[0])
+
+# NOTE: images below are placeholder illustrations, not a real captcha demo.
+backgroundFile = File.expand_path("../media/drag_drop/background.jpeg", __FILE__)
+image1File = File.expand_path("../media/drag_drop/image1.jpeg", __FILE__)
+image2File = File.expand_path("../media/drag_drop/image2.jpeg", __FILE__)
+
+backgroundStr = Base64.strict_encode64(File.binread(backgroundFile))
+image1Str = Base64.strict_encode64(File.binread(image1File))
+image2Str = Base64.strict_encode64(File.binread(image2File))
+
+begin
+  result = client.drag_drop({
+    body: backgroundStr,
+    images: [image1Str, image2Str],
+    textinstructions: "Drag the images to proper position"
+  })
+rescue StandardError => e
+  puts(e)
+end
+
+puts "Result: #{result.inspect}"

data/examples/friendly_captcha_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.friendly({
+  pageurl: "https://example.com",
+  sitekey: "2FZFEVS1FZCGQ9"
+})
+
+puts "Result: #{result.inspect}"

data/examples/funcaptcha_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.funcaptcha({
+   publickey: "69A21A01-CC7B-B9C6-0F9A-E7FA06677FFC",
+   pageurl: "https://mysite.com/page/with/funcaptcha",
+   surl: "https://client-api.arkoselabs.com"})
+
+puts "Result: #{result.inspect}"

data/examples/geetest_example.rb

@@ -0,0 +1,12 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.geetest({
+  gt: 'f1ab2cdefa3456789012345b6c78d90e',
+  api_server: 'api-na.geetest.com',
+  challenge: '12345678abc90123d45678ef90123a456b',
+  pageurl: 'https://www.site.com/page/'
+})
+
+puts "Result: #{result.inspect}"

data/examples/geetest_v4_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.geetest_v4({
+  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73',
+  pageurl: 'https://www.site.com/page/'
+})
+
+puts "Result: #{result.inspect}"

data/examples/hcaptcha_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.hcaptcha({
+  sitekey: '10000000-ffff-ffff-ffff-000000000001',
+  pageurl: 'https://www.site.com/page/'
+})
+
+puts "Result: #{result.inspect}"

data/examples/hunt_example.rb

@@ -0,0 +1,17 @@
+require_relative "../lib/api_2captcha"
+
+client = Api2Captcha.new(ARGV[0])
+
+begin
+  result = client.hunt({
+                         pageurl: "https://example.com/page-with-hunt",
+                         api_get_lib: "https://example.com/hd-api/external/apps/app-id/api.js",
+                         userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+                         proxytype: "http",
+                         proxy: "proxyuser:strongPassword@123.123.123.123:3128"
+                       })
+rescue StandardError => e
+  puts(e)
+end
+
+puts "Result: #{result.inspect}"

data/examples/key_captcha_example.rb

@@ -0,0 +1,13 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.keycaptcha({
+  s_s_c_user_id: 10,
+  s_s_c_session_id: '493e52c37c10c2bcdf4a00cbc9ccd1e8',
+  s_s_c_web_server_sign: '9006dc725760858e4c0715b835472f22-pz-',
+  s_s_c_web_server_sign2: '2ca3abe86d90c6142d5571db98af6714',
+  pageurl: 'https://www.keycaptcha.ru/demo-magnetic/'
+})
+
+puts "Result: #{result.inspect}"

data/examples/lemin_example.rb

@@ -0,0 +1,12 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.lemin({
+  captcha_id: 'CROPPED_1abcd2f_a1234b567c890d12ef3a456bc78d901d',
+  div_id: 'lemin-cropped-captcha',
+  pageurl: 'https://www.site.com/page/',
+  api_server: "https://api.leminnow.com/"
+})
+
+puts "Result: #{result.inspect}"

data/examples/mt_captcha_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.mt_captcha({
+  pageurl: "https://service.mtcaptcha.com/mtcv1/demo/index.html",
+  sitekey: "MTPublic-DemoKey9M"
+})
+
+puts "Result: #{result.inspect}"

data/examples/normal_captcha_example.rb

@@ -1,9 +1,11 @@
 require 'api_2captcha'
 
-client =  Api2Captcha.new("YOUR_API_KEY")
+client =  Api2Captcha.new(ARGV[0])
+
+image_absolute_path = File.expand_path("../media/normal_2.jpg", __FILE__)
 
 result = client.normal({
-  image: './media/normal_2.jpg',
+  image: image_absolute_path,
 })
 
 puts "Result: #{result.inspect}"

data/examples/prosopo_example.rb

@@ -0,0 +1,16 @@
+
+require_relative '../lib/api_2captcha'
+
+client =  Api2Captcha.new(ARGV[0])
+
+begin
+result = client.prosopo({
+  pageurl: "https://www.twickets.live/",
+  sitekey: "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm",
+})
+rescue StandardError => e
+    puts(e)
+end
+
+
+puts "Result: #{result.inspect}"

data/examples/recaptcha_v2_example.rb

@@ -1,6 +1,6 @@
 require 'api_2captcha'
 
-client =  Api2Captcha.new("YOUR_API_KEY")
+client =  Api2Captcha.new(ARGV[0])
 
 result = client.recaptcha_v2({
   googlekey: '6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u',

data/examples/recaptcha_v3_example.rb

@@ -0,0 +1,18 @@
+require_relative '../lib/api_2captcha'
+
+client =  Api2Captcha.new(ARGV[0])
+
+begin
+result = client.recaptcha_v3({
+                               googlekey: "6LfD3PIbAAAAAJs_eEHvoOl75_83eXSqpPSRFJ_u",
+                               pageurl: "http://2captcha.com/demo/recaptcha-v3",
+                               version: "v3",
+                               score: 0.3,
+                               action: "verify"
+                             })
+rescue StandardError => e
+    puts(e)
+end
+
+
+puts "Result: #{result.inspect}"

data/examples/rotate_example.rb

@@ -0,0 +1,13 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.rotate({
+  image: 'path/to/captcha.jpg',
+  angle: 40,
+  lang: 'en',
+  hint_image: 'path/to/hint.jpg',
+  hint_text: 'Put the images in the correct way'
+})
+
+puts "Result: #{result.inspect}"

data/examples/temu_example.rb

@@ -0,0 +1,28 @@
+
+require_relative '../lib/api_2captcha'
+
+client =  Api2Captcha.new(ARGV[0])
+
+bodyFile = File.expand_path("../media/temu/body.png", __FILE__)
+part1File = File.expand_path("../media/temu/part1.png", __FILE__)
+part2File = File.expand_path("../media/temu/part2.png", __FILE__)
+part3File = File.expand_path("../media/temu/part3.png", __FILE__)
+
+bodyStr = Base64.strict_encode64(File.binread(bodyFile))
+part1Str = Base64.strict_encode64(File.binread(part1File))
+part2Str = Base64.strict_encode64(File.binread(part2File))
+part3Str = Base64.strict_encode64(File.binread(part3File))
+
+begin
+result = client.temu({
+  body: bodyStr,
+  part1: part1Str,
+  part2: part2Str,
+  part3: part3Str,
+})
+rescue StandardError => e
+    puts(e)
+end
+
+
+puts "Result: #{result.inspect}"

data/examples/text_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.text({
+  textcaptcha:'If tomorrow is Saturday, what day is today?',
+  lang: "en"
+})
+
+puts "Result: #{result.inspect}"

data/examples/tspd_example.rb

@@ -0,0 +1,19 @@
+
+require_relative '../lib/api_2captcha'
+
+client = Api2Captcha.new(ARGV[0])
+
+begin
+  result = client.tspd({
+    pageurl: "https://example.com/page-with-tspd",
+    tspd_cookie: "TS...",
+    html_page_base64: "PGh0bWw+...",
+    userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+    proxytype: "http",
+    proxy: "proxyuser:strongPassword@123.123.123.123:3128"
+  })
+rescue StandardError => e
+  puts(e)
+end
+
+puts "Result: #{result.inspect}"

data/examples/vkcaptcha_example.ru

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.vkcaptcha({
+  redirect_uri: 'https://id.vk.com/not_robot_captcha?domain=vk.com&session_token=eyJ....HGsc5B4LyvjA&variant=popup&blank=1',
+  userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36'
+})
+
+puts "Result: #{result.inspect}"

data/examples/vkimage_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.vkimage({
+  image: '/9j/4AAQSkZJRgABAQAAAQABAAD/2...',
+  steps: '[5,19,14,14,6,4,8...]'
+})
+
+puts "Result: #{result.inspect}"

data/examples/yandex_example.rb

@@ -0,0 +1,10 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.yandex({
+  sitekey: 'Y5Lh0tiycconMJGsFd3EbbuNKSp1yaZESUOIHfeV',
+  url: "https://rutube.ru"
+})
+
+puts "Result: #{result.inspect}"

data/examples/yidun_example.rb

@@ -0,0 +1,15 @@
+
+require_relative '../lib/api_2captcha'
+
+client = Api2Captcha.new(ARGV[0])
+
+begin
+  result = client.yidun({
+    pageurl: "https://example.com/page-with-yidun",
+    sitekey: "SITE_KEY"
+  })
+rescue StandardError => e
+  puts(e)
+end
+
+puts "Result: #{result.inspect}"

data/howto.txt

@@ -0,0 +1,8 @@
+
+ruby examples/prosopo_example.rb API_KEY
+
+API_KEY=API_KEY_123 rspec spec/api_2captcha_spec.rb --tag recaptcha_v3
+
+rake spec
+rake -T
+ruby api_2captcha_spec.rb

data/lib/api_2captcha/client.rb

@@ -134,7 +134,7 @@ module Api2Captcha
     end
 
     def grid(params)
-      params[:recaptcha] = 1
+      params["recaptcha"] = 1
       solve("post", **params)
     end
 
@@ -170,6 +170,14 @@ module Api2Captcha
       solve("amazon_waf", **params)
     end
 
+    def vkimage(params)
+      solve("vkimage", **params)
+    end
+
+    def vkcaptcha(params)
+      solve("vkcaptcha", **params)
+    end
+
     def audio(params)
       audio = params.delete(:audio)
       audio_content = File.file?(audio) ? File.binread(audio) : audio
@@ -213,6 +221,50 @@ module Api2Captcha
       solve("atb_captcha", **params)
     end
 
+    def prosopo(params)
+      solve("prosopo", **params)
+    end
+
+    def captchafox(params)
+      solve("captchafox", **params)
+    end
+
+    def altcha(params)
+      solve("altcha", **params)
+    end
+
+    def temu(params)
+      solve("temuimage", **params)
+    end
+
+    def binance(params)
+      solve("binance", **params)
+    end
+
+    def hunt(params)
+      solve("hunt", **params)
+    end
+
+    def tspd(params)
+      solve("tspd", **params)
+    end
+
+    def basilisk(params)
+      solve("basilisk", **params)
+    end
+
+    def alibaba(params)
+      solve("alibaba", **params)
+    end
+
+    def yidun(params)
+      solve("yidun", **params)
+    end
+
+    def drag_drop(params)
+      solve("drag_drop", **params)
+    end
+
     private
 
     def base_url

data/lib/api_2captcha/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Api2Captcha
-  VERSION = "1.1.6"
+  VERSION = "1.2.0"
 end

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: ruby-2captcha
 version: !ruby/object:Gem::Version
-  version: 1.1.6
+  version: 1.2.0
 platform: ruby
 authors:
 - 2captcha.com
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-20 00:00:00.000000000 Z
+date: 2026-09-17 00:00:00.000000000 Z
 dependencies: []
 description: Ruby package for easy integration with the API of 2captcha captcha solving
-  service to bypass recaptcha, hcaptcha, funcaptcha, geetest and solve any other captchas.
+  service to bypass recaptcha, funcaptcha, geetest and solve any other captchas.
 email:
 - info@2captcha.com
 executables: []
@@ -29,16 +29,57 @@ files:
 - README.ru.md
 - Rakefile
 - api_2captcha.gemspec
+- examples/alibaba_example.rb
+- examples/altcha_example.rb
+- examples/amazon_waf_example.rb
 - examples/atb_captcha_example.rb
 - examples/audio_example.rb
+- examples/basilisk_example.rb
+- examples/binance_example.rb
+- examples/canvas_example.rb
+- examples/captchafox_example.rb
+- examples/capy_example.rb
+- examples/cloudflare_turnstile_example.rb
+- examples/coordinates_example.rb
+- examples/cut_captcha_example.rb
+- examples/cyber_siara_example.rb
+- examples/datadome_example.rb
+- examples/drag_drop_example.rb
+- examples/friendly_captcha_example.rb
+- examples/funcaptcha_example.rb
+- examples/geetest_example.rb
+- examples/geetest_v4_example.rb
 - examples/grid_captcha_example.rb
+- examples/hcaptcha_example.rb
+- examples/hunt_example.rb
+- examples/key_captcha_example.rb
+- examples/lemin_example.rb
+- examples/media/drag_drop/background.jpeg
+- examples/media/drag_drop/image1.jpeg
+- examples/media/drag_drop/image2.jpeg
 - examples/media/example.mp3
 - examples/media/normal_2.jpg
 - examples/media/recaptchaGrid4x4.jpg
 - examples/media/recaptchaGridImginstructions4x4.jpg
+- examples/media/temu/body.png
+- examples/media/temu/part1.png
+- examples/media/temu/part2.png
+- examples/media/temu/part3.png
+- examples/mt_captcha_example.rb
 - examples/normal_captcha_example.rb
+- examples/prosopo_example.rb
 - examples/recaptcha_v2_example.rb
+- examples/recaptcha_v3_example.rb
+- examples/rotate_example.rb
+- examples/temu_example.rb
 - examples/tencent_example.rb
+- examples/text_example.rb
+- examples/tspd_example.rb
+- examples/vkcaptcha_example.ru
+- examples/vkimage_example.rb
+- examples/yandex_example.rb
+- examples/yidun_example.rb
+- howto.txt
 - lib/api_2captcha.rb
 - lib/api_2captcha/api2captcha_exceptions.rb
 - lib/api_2captcha/client.rb
@@ -56,7 +97,7 @@ metadata:
   keywords: 2captcha, captcha solver, captcha bypass, Ruby, automation, CAPTCHA API,
     CAPTCHA recognition, anti-captcha, reCAPTCHA, OCR, image recognition, human verification,
     bot protection, recaptcha
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -71,8 +112,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
-signing_key: 
+rubygems_version: 3.4.1
+signing_key:
 specification_version: 4
 summary: 2Captcha API wrapper for Ruby.
 test_files: []