anti_captcha 2.4.0 → 2.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c007c351a8655684c2f4680ead884429b8bea0ebd1fb33568119b15b477fcc76
-  data.tar.gz: 38267b78fb266cbb281a3d28db9cf32633398798a270bdc9e2bbd4f87cc2d84a
+  metadata.gz: 7911a78f0b2ccdcb075555ea6ea96aa2abc6914311b792a4b2579ec1a3bc8901
+  data.tar.gz: f2e2df9d4ba1042fed67fed6d670dd6c22fc097f0856fa61e1da17a74483043c
 SHA512:
-  metadata.gz: 6bd0a5e3759806d4d88285d819a2d18738a47d560d2a4a25ab6497d1a7d12b3e07a34f0e7c2d1ac5755a1b7238a975fc45b49594019076f0fd53584dee67e085
-  data.tar.gz: 43a55d65f865c263b0fa732984a085b92ae5936530f8d6f6cc5a7e619e261629a3c4991907a85838b76968e73827270d3e580938c9adea23280a27a52e000ab4
+  metadata.gz: f1915d353fe91b85276cb5ace41c09b3762b8313c2903ab064f2f9fdb6572b151bfd2357f6a80f6883e4922773aeb096d3cca57c2939b309f093ef4f844cf181
+  data.tar.gz: cf6cdc10ac27031ccd362d8fb15da2af3d4e77cc849a4ab905854c831977b20c89a38fd47cad502f778d6b359493a45d4add2d0f5512f1984b0dcda23822e3a7

data/README.md

@@ -2,9 +2,6 @@
 
 AntiCaptcha is a Ruby API for Anti-Captcha - [Anti-Captcha.com](http://getcaptchasolution.com/ipuz16klxh)
 
-> We suggest you to also check the recommended CAPTCHA provider DeathByCaptcha.
-> The gem for this provider is available at https://github.com/infosimples/deathbycaptcha.
-
 ## Installation
 
 Add this line to your application's Gemfile:
@@ -94,8 +91,8 @@ solution.g_recaptcha_response
 solution = client.decode_recaptcha_v3!(
   website_key:   'xyz',
   website_url:   'http://example.com/example=1',
-  min_score:     0.3,
   page_action:   'myverify',
+  min_score:     0.3,   # OPTIONAL
   # is_enterprise: false, # OPTIONAL
 )
 
@@ -242,6 +239,33 @@ solution.v4['captcha_output']
 - `proxy_password`: optional parameter. The proxy password.
 - `user_agent`: optional parameter. The user agent.
 
+#### Cloudflare Turnstile
+
+```ruby
+solution = client.decode_turnstile!(
+  website_key:    'xyz',
+  website_url:    'http://example.com/example=1',
+  # proxy_type:     'http',                   # OPTIONAL
+  # proxy_address:  '127.0.0.1',              # OPTIONAL
+  # proxy_port:     '8080',                   # OPTIONAL
+  # proxy_login:    'proxyLoginHere',         # OPTIONAL
+  # proxy_password: 'proxyPasswordHere',      # OPTIONAL
+)
+
+solution.token
+"0.vtJqmZnvobaUzK2i2PyKaSqHELYtBZfRoPwMvLMdA81WL_9G0vCO3y2VQVIeVplG0mxYF7uX......."
+```
+
+*Parameters:*
+
+- `website_key`: the site key for the Turnstile.
+- `website_url`: the URL of the page with the Turnstile challenge.
+- `proxy_type`: optional parameter. Proxy connection protocol.
+- `proxy_address`: optional parameter. The proxy address.
+- `proxy_port`: optional parameter. The proxy port.
+- `proxy_login`: optional parameter. The proxy login.
+- `proxy_password`: optional parameter. The proxy password.
+
 ### 3. Report an incorrectly solved image CAPTCHA for a refund
 
 It is only possible to report incorrectly solved image CAPTCHAs.
@@ -276,6 +300,8 @@ Queue IDs:
 - `23` Recaptcha Enterprise V2 with proxy
 - `24` Recaptcha Enterprise V2 without proxy
 - `25` AntiGateTask
+- `26` Turnstile with proxy
+- `27` Turnstile without proxy
 
 ```ruby
 client.get_queue_stats!(queue_id)
@@ -290,7 +316,7 @@ avoid conflicts with other gems.
 
 ### Input image format
 
-Any format you use in the `decode_image!` method (`file`, `path`, `body`, `body64`)
+Any format you use in the `decode_image!` method (`file`, `path`, `body` or `body64`)
 will always be converted to a `body64`, which is a base64-encoded binary string.
 So, if you already have this format on your end, there is no need for convertions
 before calling the API.

data/lib/anti_captcha/client.rb

@@ -4,7 +4,7 @@ module AntiCaptcha
   #
   class Client
     BASE_URL = 'https://api.anti-captcha.com/:action'
-    PROXYABLE_TASKS = %w(RecaptchaV2Task FunCaptchaTask HCaptchaTask GeeTestTask)
+    PROXYABLE_TASKS = %w(RecaptchaV2Task FunCaptchaTask HCaptchaTask GeeTestTask TurnstileTask)
 
     attr_accessor :client_key, :timeout, :polling
 
@@ -246,6 +246,40 @@ module AntiCaptcha
       AntiCaptcha::GeetestSolution.new(task_result)
     end
 
+    #
+    # Decodes a Turnstile CAPTCHA.
+    #
+    # @see `AntiCaptcha::Client#decode_turnstile!`
+    #
+    def decode_turnstile(options, proxy = nil)
+      decode_turnstile!(options, proxy)
+    rescue
+      AntiCaptcha::TurnstileSolution.new
+    end
+
+    #
+    # Decodes a Turnstile CAPTCHA.
+    #
+    # @param [Hash] options Options hash.
+    #   @option options [String]  :website_url
+    #   @option options [String]  :website_key
+    #
+    # @param [Hash] proxy Not mandatory. A hash with configs of the proxy that
+    #                     has to be used. Defaults to `nil`.
+    #   @option proxy [String]  :proxy_type
+    #   @option proxy [String]  :proxy_address
+    #   @option proxy [String]  :proxy_port
+    #   @option proxy [String]  :proxy_login
+    #   @option proxy [String]  :proxy_password
+    #
+    # @return [AntiCaptcha::TurnstileSolution] The solution of the Turnstile.
+    #
+    def decode_turnstile!(options, proxy = nil)
+      task = create_task!('TurnstileTask', options, proxy)
+      task_result = get_task_result!(task['taskId'])
+      AntiCaptcha::TurnstileSolution.new(task_result)
+    end
+
     # Creates a task for solving the selected CAPTCHA type.
     #
     # @param [String] type The type of the CAPTCHA.
@@ -349,6 +383,13 @@ module AntiCaptcha
         args[:version]                   = options[:version]                      if !options[:version].nil?
         args[:initParameters]            = options[:init_parameters]              if !options[:init_parameters].nil?
 
+      when 'TurnstileTask'
+        args[:task] = {
+          type:       'TurnstileTask',
+          websiteURL: options[:website_url],
+          websiteKey: options[:website_key],
+        }
+
       else
         message = "Invalid task type: '#{type}'."
         raise AntiCaptcha::ArgumentError.new(message)
@@ -421,6 +462,8 @@ module AntiCaptcha
     #                          20 - Recaptcha V3 s0.9
     #                          21 - hCaptcha Proxy-On
     #                          22 - hCaptcha Proxyless
+    #                          26 - Turnstile Proxy-On
+    #                          27 - Turnstile Proxyless
     #
     # @return [Hash] Information about the queue.
     #

data/lib/anti_captcha/models/turnstile_solution.rb

@@ -0,0 +1,13 @@
+module AntiCaptcha
+  class TurnstileSolution < AntiCaptcha::Solution
+    attr_accessor :token
+
+    def initialize(task_result = nil)
+      super
+
+      if task_result
+        @token = task_result.api_result['solution']['token']
+      end
+    end
+  end
+end

data/lib/anti_captcha/version.rb

@@ -1,4 +1,4 @@
 module AntiCaptcha
-  VERSION = "2.4.0"
+  VERSION = "2.5.0"
   USER_AGENT = "AntiCaptcha/Ruby v#{VERSION}"
 end

data/lib/anti_captcha.rb

@@ -38,6 +38,7 @@ require 'anti_captcha/models/recaptcha_v3_solution'
 require 'anti_captcha/models/fun_captcha_solution'
 require 'anti_captcha/models/h_captcha_solution'
 require 'anti_captcha/models/geetest_solution'
+require 'anti_captcha/models/turnstile_solution'
 require 'anti_captcha/models/task_result'
 require 'anti_captcha/client'
 require 'anti_captcha/version'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anti_captcha
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors:
 - Infosimples
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-09-30 00:00:00.000000000 Z
+date: 2024-08-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -82,12 +82,13 @@ files:
 - lib/anti_captcha/models/recaptcha_v3_solution.rb
 - lib/anti_captcha/models/solution.rb
 - lib/anti_captcha/models/task_result.rb
+- lib/anti_captcha/models/turnstile_solution.rb
 - lib/anti_captcha/version.rb
 homepage: https://github.com/infosimples/anti_captcha
 licenses:
 - MIT
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -102,8 +103,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key:
+rubygems_version: 3.5.6
+signing_key: 
 specification_version: 4
 summary: Ruby API for Anti Captcha (CAPTCHA Solver as a Service)
 test_files: []