ruby-2captcha 1.1.6 → 1.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f3cf34c705f05cac002afa61dbfe4ded7b7e1f07a579fa0d2e98c52ec1972ebc
-  data.tar.gz: 7aeb0c18eb4f7136278ef3ab528312eced958cd4ef1ebd2ee33a44296e4ed416
+  metadata.gz: 6e27af7b5ab7e5e7a117b7598d8eb609ca10bee60174078691eda86265e8d464
+  data.tar.gz: 21dcd54bfe95f730b5887e41bdbdec5baca72eb915e8b8125f1006c59821640b
 SHA512:
-  metadata.gz: c092dcb03fc11e1de8aff2a41b7b1b8908ee19e66dd643d8aaf4dd12cdab9d920e68a60b6f63c55e6ea9271b93f8b9d54aa3ea1d0991e8f11ae9cbad48d1b813
-  data.tar.gz: 7c42d06519aa623dcf5652d036bc85864f1df0725d913c3c7be2d3be2f7b8502367ed802ccba7f3908a3f2bf711840a50e36a54c53b4a35df0b9699cb008fc4b
+  metadata.gz: 69eeb331f6d5104521ffceaaa3268cab0c48c502e9e390d9e6d259cdfb568027f2ffbd82cbcf445797663fd6f9deaf89537a88e50e42459ca70df6b53af54a79
+  data.tar.gz: c25f4db3a71a56f95846964081f986765007a38a493917d496e3e21f2a6b974b2917788b35265d2c622a13f99bac620e89cefb121890b099da91fade1759fa1c

data/.rspec_status

@@ -1,7 +1,16 @@
-example_id                         | status | run_time              |
----------------------------------- | ------ | --------------------- |
-./spec/api_2captcha_spec.rb[1:1]   | passed | 0.04326 seconds       |
-./spec/api_2captcha_spec.rb[1:2:1] | passed | 0.00121 seconds       |
-./spec/api_2captcha_spec.rb[1:3:1] | passed | 3.15 seconds          |
-./spec/api_2captcha_spec.rb[1:4:1] | passed | 2 minutes 0.2 seconds |
-./spec/api_2captcha_spec.rb[1:5:1] | passed | 0.26142 seconds       |
+example_id                          | status  | run_time              |
+----------------------------------- | ------- | --------------------- |
+./spec/api_2captcha_spec.rb[1:1]    | passed  | 0.00056 seconds       |
+./spec/api_2captcha_spec.rb[1:2:1]  | passed  | 0.00041 seconds       |
+./spec/api_2captcha_spec.rb[1:3:1]  | passed  | 1.52 seconds          |
+./spec/api_2captcha_spec.rb[1:4:1]  | passed  | 23.45 seconds         |
+./spec/api_2captcha_spec.rb[1:5:1]  | passed  | 0.60409 seconds       |
+./spec/api_2captcha_spec.rb[1:6:1]  | passed  | 12.42 seconds         |
+./spec/api_2captcha_spec.rb[1:7:1]  | passed  | 1.37 seconds          |
+./spec/api_2captcha_spec.rb[1:8:1]  | passed  | 1 minute 4.24 seconds |
+./spec/api_2captcha_spec.rb[1:9:1]  | unknown |                       |
+./spec/api_2captcha_spec.rb[1:10:1] | unknown |                       |
+./spec/api_2captcha_spec.rb[1:11:1] | unknown |                       |
+./spec/api_2captcha_spec.rb[1:12:1] | unknown |                       |
+./spec/api_2captcha_spec.rb[1:13:1] | unknown |                       |
+./spec/api_2captcha_spec.rb[1:14:1] | passed  | 0.29802 seconds       |

data/.ruby-version

@@ -1 +1 @@
-2.6.0
+3.2.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    ruby-2captcha (1.1.5)
+    ruby-2captcha (1.2.0)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -44,6 +44,19 @@ Examples of API requests for different captcha types are available on the [Ruby
       - [Cutcaptcha](#cutcaptcha)
       - [Tencent](#tencent)
       - [atbCAPTCHA](#atbcaptcha)
+      - [Prosopo](#prosopo)
+      - [Captchafox](#captchafox)
+      - [Temu](#temu)
+      - [VK Image](#vk-image)
+      - [VK Captcha](#vk-captcha)
+      - [Altcha Captcha](#altcha-captcha)
+      - [Hunt Captcha](#hunt-captcha)
+      - [Tspd](#tspd)
+      - [Basilisk](#basilisk)
+      - [Alibaba](#alibaba)
+      - [Yidun](#yidun)
+      - [Drag & Drop Captcha](#drag--drop-captcha)
+      - [Imperva (Incapsula)](#imperva-incapsula)
     - [Other methods](#other-methods)
       - [send / get_result](#send--get_result)
       - [balance](#balance)
@@ -93,7 +106,7 @@ client.api_key = "YOUR_API_KEY"
 
 |Option          |Default value|Description                                                             |
 |----------------|-------------|------------------------------------------------------------------------|
-|soft_id         |4584            |your software ID obtained after publishing in [2captcha sofware catalog]|
+|soft_id         |4584            |your software ID obtained after publishing in [2captcha software catalog]|
 |callback        |-            |URL of your web-sever that receives the captcha recognition result. The URl should be first registered in [pingback settings] of your account|
 |default_timeout |120          |Timeout in seconds for all captcha types except reCAPTCHA. Defines how long the module tries to get the answer from `res.php` API endpoint|
 |polling_interval|10           |Interval in seconds between requests to `res.php` API endpoint, setting values less than 5 seconds is not recommended|
@@ -110,7 +123,7 @@ When you submit any image-based captcha use can provide additional options to he
 | Option        | Default Value | Description                                                                                        |
 | ------------- | ------------- | -------------------------------------------------------------------------------------------------- |
 | numeric       | 0             | Defines if captcha contains numeric or other symbols [see more info in the API docs][normal_post] |
-| min_len       | 0             | minimal answer lenght                                                                              |
+| min_len       | 0             | minimal answer length                                                                              |
 | max_len       | 0             | maximum answer length                                                                              |
 | phrase        | 0             | defines if the answer contains multiple words or not                                               |
 | case_sensitive| 0             | defines if the answer is case sensitive                                                            |
@@ -494,6 +507,211 @@ result = client.atb_captcha({
 })
 ```
 
+### Prosopo
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#prosopo-procaptcha)</sup>
+
+Token-based method for automated solving of Prosopo.
+
+```ruby
+result = client.prosopo({
+  pageurl: "https://www.twickets.live/",
+  sitekey: "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"
+})
+```
+
+### Captchafox
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#captchafox)</sup>
+
+Token-based method for automated solving of Captchafox.
+
+```ruby
+  result = client.captchafox({
+        sitekey: "sitekey",
+        pageurl: "https://pageurl/",
+        api_server: "https://mam.example.com",
+        userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/131.0.0.0 Safari/537.36",
+        proxytype: "socks5",
+        proxy: "proxyuser:strongPassword@123.123.123.123:3128"
+               })
+```
+
+### Temu
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#temucaptcha)</sup>
+
+Token-based method for automated solving of Temu.
+
+```ruby
+result = client.temu({
+  body: bodyStr,
+  part1: part1Str,
+  part2: part2Str,
+  part3: part3Str,
+})
+```
+
+
+### VK Image
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vk-captcha)</sup>
+
+We use the body (image in base64 format) or file (image as file) and steps parameters.
+You can get both values from the response to the request https://api.vk.com/method/captchaNotRobot.getContent?v={API_VER} when loading the captcha widget on the page.
+
+```ruby
+result = client.vkimage({
+  image: '/9j/4AAQSkZJRgABAQAAAQABAAD/2...',
+  steps: '[5,19,14,14,6,4,8...]'
+})
+```
+
+### VK Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#vk-captcha)</sup>
+
+Token-based method requires redirect_uri parameter, as well as proxy and userAgent. The value of the redirect_uri parameter can be found in the response to requests to the VK API that return captchas.
+
+```ruby
+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'
+})
+```
+
+### Altcha Captcha
+<sup>[API method description.](https://2captcha.com/2captcha-api#altchacaptcha)</sup>
+
+Use this method to solve Altcha Captcha. Returns a token.
+
+```ruby
+  result = client.altcha({
+    pageurl: 'https://mysite.com/page/with/altcha',
+    challenge: '{"algorithm":"SHA-256","challenge":"a4c9d8e7f1b23a6c...","signature":"7b3e2a9d5c8f1046e2d91c3a..."}'
+    # or:
+    # challenge_url: 'https://example.com/altcha-challenge'
+  })
+```
+
+### Hunt Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#hunt)</sup>
+
+Token-based method for automated solving of Hunt captcha. Uses a two-step workflow: the first request without `data` returns an X-HD fingerprint; after sending it to the site and receiving `meta.token`, a second request with `data` returns the final token.
+
+> [!IMPORTANT]
+> To solve the Hunt captcha, you must use a proxy. It is recommended to use [residential proxies].
+
+```ruby
+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"
+})
+```
+
+### Tspd
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#tspd)</sup>
+
+Use this method to solve TSPD captcha. Returns cookies. A proxy is required — there is no proxyless variant.
+
+> [!IMPORTANT]
+> To solve the TSPD captcha, you must use a proxy. The same outbound IP address must be maintained across all stages: getting cookies, solving the task, and using the result.
+
+```ruby
+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"
+})
+```
+
+### Basilisk
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#basilisk)</sup>
+
+Token-based method for automated solving of Basilisk captcha.
+
+```ruby
+result = client.basilisk({
+  pageurl: "https://example.com/page-with-basilisk",
+  sitekey: "SITE_KEY"
+})
+```
+
+### Alibaba
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#alibaba)</sup>
+
+Token-based method for automated solving of Alibaba captcha.
+
+```ruby
+result = client.alibaba({
+  pageurl: "https://example.com/page-with-alibaba",
+  scene_id: "SCENE_ID",
+  prefix: "PREFIX"
+})
+```
+
+### Yidun
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#yidun)</sup>
+
+Token-based method for automated solving of Yidun captcha.
+
+```ruby
+result = client.yidun({
+  pageurl: "https://example.com/page-with-yidun",
+  sitekey: "SITE_KEY"
+})
+```
+
+### Drag & Drop Captcha
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#drag-and-drop-captcha)</sup>
+
+Use this method to solve captchas where one or more images need to be dragged onto specific positions of a background image. `body` is the background image and `images` is an array of the images to drag onto it, both Base64-encoded — read the files and encode them yourself, as shown below. The order of `images` matters: the result uses the same order.
+
+The result is a string with coordinates for each image from `images`, separated by `|`. An image that doesn't need to be moved comes back as the literal string `null`.
+
+```ruby
+result = client.drag_drop({
+  body: bodyStr,
+  images: [image1Str, image2Str],
+  textinstructions: "Drag the images to proper position"
+})
+```
+
+### Imperva (Incapsula)
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#imperva)</sup>
+
+Cookie-based method for automated solving of Imperva (Incapsula) captcha. `incapsula_script_url` and `incapsula_cookies` are generated dynamically and may differ on each page load. Optionally pass `reese84_url_endpoint` if the site uses Reese84, and `userAgent` of the browser that opens the page.
+
+The result contains cookies for each domain in `request.domains`, which should be sent to the target site. If `request.headers.User-Agent` is returned, use the same User-Agent in requests to the site.
+
+> [!IMPORTANT]
+> To solve the Imperva captcha, you must use a proxy. It is recommended to use [residential proxies].
+
+```ruby
+result = client.imperva({
+  pageurl: "https://example.com/page-with-imperva",
+  incapsula_script_url: "/_Incapsula_Resource?SWUDNSAI=31&xinfo=1",
+  incapsula_cookies: "visid_incap_123456=sample; incap_ses_123_123456=sample",
+  reese84_url_endpoint: "https://example.com/_Incapsula_Resource?reese84=1",
+  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"
+})
+```
+
 ## Other methods
 
 ### send / get_result
@@ -600,11 +818,11 @@ The graphics and trademarks included in this repository are not covered by the M
 
 <!-- Shared links -->
 [2Captcha]: https://2captcha.com/
-[2captcha sofware catalog]: https://2captcha.com/software
+[2captcha software catalog]: https://2captcha.com/software
 [pingback settings]: https://2captcha.com/setting/pingback
 [normal_post]: https://2captcha.com/2captcha-api#normal_post
 [list of supported languages]: https://2captcha.com/2captcha-api#language
 [Buy residential proxies]: https://2captcha.com/proxy/residential-proxies
 [Quick start]: https://2captcha.com/proxy?openAddTrafficModal=true
 [examples]: ./examples/
-[residential proxies]: https://2captcha.com/proxy/residential-proxies
+[residential proxies]: https://2captcha.com/proxy/residential-proxies

data/README.ru.md

@@ -41,6 +41,19 @@
     - [Cutcaptcha](#cutcaptcha)
     - [Tencent](#tencent)
     - [atbCAPTCHA](#atbcaptcha)
+    - [Prosopo](#prosopo)
+    - [Captchafox](#captchafox)
+    - [Temu](#temu)
+    - [VK Captcha](#vk-captcha)
+    - [Altcha Captcha](#altcha-captcha)
+    - [Binancecaptcha](#binancecaptcha)
+    - [Hunt Captcha](#hunt-captcha)
+    - [Tspd](#tspd)
+    - [Basilisk](#basilisk)
+    - [Alibaba](#alibaba)
+    - [Yidun](#yidun)
+    - [Drag & Drop Captcha](#drag--drop-captcha)
+    - [Imperva (Incapsula)](#imperva-incapsula)
   - [Другие методы](#другие-методы)
     - [send / get_result](#send--get_result)
     - [Баланс](#баланс)
@@ -476,6 +489,220 @@ result = client.atb_captcha({
 })
 ```
 
+### Prosopo
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#prosopo-procaptcha)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Prosopo.
+
+```ruby
+result = client.prosopo({
+  pageurl: "https://www.twickets.live/",
+  sitekey: "5EZVvsHMrKCFKp5NYNoTyDjTjetoVo1Z4UNNbTwJf1GfN6Xm"
+})
+```
+
+### Captchafox
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#captchafox)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Captchafox.
+
+```ruby
+  result = client.captchafox({
+        sitekey: "sitekey",
+        pageurl: "https://pageurl/",
+        api_server: "https://mam.example.com",
+        userAgent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/131.0.0.0 Safari/537.36",
+        proxytype: "socks5",
+        proxy: "proxyuser:strongPassword@123.123.123.123:3128"
+               })
+```
+
+### Temu
+
+<sup>[API method description.](https://2captcha.com/2captcha-api#temucaptcha)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Temu.
+
+```ruby
+result = client.temu({
+  body: bodyStr,
+  part1: part1Str,
+  part2: part2Str,
+  part3: part3Str,
+### VK Image
+
+<sup>[API описание метода.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+Мы используем текст (изображение в формате base64) или файл (изображение как файл) и параметры steps.
+Вы можете получить оба значения из ответа на запрос https://api.vk.com/method/captchaNotRobot.getContent?v={API_VER} при загрузке виджета captcha на страницу.
+
+```ruby
+result = client.vkimage({
+  image: '/9j/4AAQSkZJRgABAQAAAQABAAD/2...',
+  steps: '[5,19,14,14,6,4,8...]'
+})
+```
+
+### VK Captcha
+
+<sup>[API описание метода.](https://2captcha.com/2captcha-api#vkcaptcha)</sup>
+
+Для метода, основанного на токенах, требуется параметр `redirect_uri`, а также прокси-сервер и UserAgent. Значение параметра `redirect_uri` можно найти в ответах на запросы к VK API, которые возвращают captcha.
+
+```ruby
+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'
+})
+```
+
+### Altcha Captcha
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#altchacaptcha)</sup>
+
+Используйте этот метод для решения капчи Altcha. В ответ возвращается токен.
+
+```ruby
+result = client.altcha({
+  pageurl: 'https://mysite.com/page/with/altcha',
+  challenge: '{"algorithm":"SHA-256","challenge":"a4c9d8e7f1b23a6c...","signature":"7b3e2a9d5c8f1046e2d91c3a..."}'
+  # или:
+  # challenge_url: 'https://example.com/altcha-challenge'
+})
+```
+
+### Binancecaptcha
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#binance)</sup>
+
+Используйте этот метод для решения капчи Binancecaptcha. В ответ возвращается токен.
+
+```ruby
+result = client.binance({
+          sitekey => "login",
+          url     => "https://example.com/page-with-binance",
+          validate_id => "cb0bfef...e54ecd57b"
+})
+```
+
+### Hunt Captcha
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#hunt)</sup>
+
+Основанный на токенах метод автоматизированного решения Hunt captcha. Использует двухшаговый процесс: первый запрос без `data` возвращает X-HD fingerprint; после отправки его на сайт и получения `meta.token` второй запрос с `data` возвращает финальный токен.
+
+> [!IMPORTANT]
+> Для решения Hunt captcha необходимо использовать прокси. Рекомендуется использовать [резидентные прокси].
+
+```ruby
+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"
+})
+```
+
+### Tspd
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#tspd)</sup>
+
+Используйте этот метод для решения капчи TSPD. В ответ возвращаются cookies. Прокси обязателен — режима без прокси не существует.
+
+> [!IMPORTANT]
+> Для решения TSPD captcha необходимо использовать прокси. Один и тот же IP-адрес должен использоваться на всех этапах: получение cookies, решение задачи и использование результата.
+
+```ruby
+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"
+})
+```
+
+### Basilisk
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#basilisk)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Basilisk.
+
+```ruby
+result = client.basilisk({
+  pageurl: "https://example.com/page-with-basilisk",
+  sitekey: "SITE_KEY"
+})
+```
+
+### Alibaba
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#alibaba)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Alibaba.
+
+```ruby
+result = client.alibaba({
+  pageurl: "https://example.com/page-with-alibaba",
+  scene_id: "SCENE_ID",
+  prefix: "PREFIX"
+})
+```
+
+### Yidun
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#yidun)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Yidun.
+
+```ruby
+result = client.yidun({
+  pageurl: "https://example.com/page-with-yidun",
+  sitekey: "SITE_KEY"
+})
+```
+
+### Drag & Drop Captcha
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#drag-and-drop-captcha)</sup>
+
+Используйте этот метод для решения капч, где одну или несколько картинок нужно перетащить на определённые позиции фонового изображения. `body` — фоновое изображение, `images` — массив изображений для перетаскивания, оба в Base64 — файлы нужно прочитать и закодировать самостоятельно, как показано ниже. Порядок `images` важен: в ответе используется тот же порядок.
+
+В ответе приходит строка с координатами для каждой картинки из `images`, разделёнными `|`. Если картинку двигать не нужно, для неё возвращается буквальное значение `null`.
+
+```ruby
+result = client.drag_drop({
+  body: bodyStr,
+  images: [image1Str, image2Str],
+  textinstructions: "Drag the images to proper position"
+})
+```
+
+### Imperva (Incapsula)
+
+<sup>[Описание метода API](https://2captcha.com/2captcha-api#imperva)</sup>
+
+Основанный на cookies метод автоматизированного решения капчи Imperva (Incapsula). Параметры `incapsula_script_url` и `incapsula_cookies` генерируются динамически и могут отличаться при каждой загрузке страницы. Необязательно можно передать `reese84_url_endpoint`, если он нужен на конкретном сайте, и `userAgent` браузера, с которым открывается страница.
+
+В ответе приходят cookies для каждого домена в `request.domains` — их нужно передать на целевой сайт. Если в ответе пришёл `request.headers.User-Agent`, используйте тот же User-Agent в запросах к сайту.
+
+> [!IMPORTANT]
+> Для решения Imperva captcha необходимо использовать прокси. Рекомендуется использовать [резидентные прокси].
+
+```ruby
+result = client.imperva({
+  pageurl: "https://example.com/page-with-imperva",
+  incapsula_script_url: "/_Incapsula_Resource?SWUDNSAI=31&xinfo=1",
+  incapsula_cookies: "visid_incap_123456=sample; incap_ses_123_123456=sample",
+  reese84_url_endpoint: "https://example.com/_Incapsula_Resource?reese84=1",
+  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"
+})
+```
 
 ## Другие методы
 

data/api_2captcha.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email = ["info@2captcha.com"]
 
   spec.summary = "2Captcha API wrapper for Ruby."
-  spec.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."
+  spec.description = "Ruby package for easy integration with the API of 2captcha captcha solving service to bypass recaptcha, funcaptcha, geetest and solve any other captchas."
   spec.homepage = "https://2captcha.com/"
   spec.license = "MIT"
   spec.required_ruby_version = ">= 2.6.0"

data/examples/alibaba_example.rb

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

data/examples/altcha_example.rb

@@ -0,0 +1,12 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.altcha({
+    pageurl: 'https://mysite.com/page/with/altcha',
+    challenge: '{"algorithm":"SHA-256","challenge":"a4c9d8e7f1b23a6c...","signature":"7b3e2a9d5c8f1046e2d91c3a..."}'
+    # or:
+    # challenge_url: 'https://example.com/altcha-challenge'
+})
+
+puts "Result: #{result.inspect}"

data/examples/amazon_waf_example.rb

@@ -0,0 +1,14 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.amazon_waf({
+  sitekey: '0x1AAAAAAAAkg0s2VIOD34y5',
+  iv: 'CgAHbCe2GgAAAAAj',
+  context: '9BUgmlm48F92WUoqv97a49ZuEJJ50TCk9MVr3C7WMtQ0X6flVbufM4n8mjFLmbLVAPgaQ1Jydeaja94iAS49ljb+sUNLoukWedAQZKrlY4RdbOOzvcFqmD/ZepQFS9N5w15Exr4VwnVq+HIxTsDJwRviElWCdzKDebN/mk8/eX2n7qJi5G3Riq0tdQw9+C4diFZU5E97RSeahejOAAJTDqduqW6uLw9NsjJBkDRBlRjxjn5CaMMo5pYOxYbGrM8Un1JH5DMOLeXbq1xWbC17YSEoM1cRFfTgOoc+VpCe36Ai9Kc=',
+  pageurl: 'https://non-existent-example.execute-api.us-east-1.amazonaws.com/latest',
+  challenge_script: "https://41bcdd4fb3cb.610cd090.us-east-1.token.awswaf.com/41bcdd4fb3cb/0d21de737ccb/cd77baa6c832/challenge.js",
+  captcha_script: "https://41bcdd4fb3cb.610cd090.us-east-1.captcha.awswaf.com/41bcdd4fb3cb/0d21de737ccb/cd77baa6c832/captcha.js"
+})
+
+puts "Result: #{result.inspect}"

data/examples/basilisk_example.rb

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

data/examples/binance_example.rb

@@ -0,0 +1,17 @@
+
+require_relative '../lib/api_2captcha'
+
+client =  Api2Captcha.new(ARGV[0])
+
+begin
+result = client.binance({
+          sitekey => "login",
+          url     => "https://example.com/page-with-binance",
+          validate_id => "cb0bfef...e54ecd57b"
+})
+rescue StandardError => e
+    puts(e)
+end
+
+
+puts "Result: #{result.inspect}"

data/examples/canvas_example.rb

@@ -0,0 +1,13 @@
+require 'api_2captcha'
+
+client =  Api2Captcha.new("YOUR_API_KEY")
+
+result = client.canvas({
+  image: 'path/to/captcha.jpg',
+  previous_id: 0,
+  lang: 'en',
+  hint_image: 'path/to/hint.jpg',
+  hint_text: 'Draw around apple'
+})
+
+puts "Result: #{result.inspect}"