ruby-2captcha 1.1.5 → 1.2.0

data/README.ru.md

@@ -1,42 +1,69 @@
-# Ruby 2Captcha API Client
+<a href="https://github.com/2captcha/2captcha-python"><img src="https://github.com/user-attachments/assets/37e1d860-033b-4cf3-a158-468fc6b4debc" width="82" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-javascript"><img src="https://github.com/user-attachments/assets/4d3b4541-34b2-4ed2-a687-d694ce67e5a6" width="36" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-go"><img src="https://github.com/user-attachments/assets/ab22182e-6cb2-41fa-91f4-d5e89c6d7c6f" width="63" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-ruby"><img src="https://github.com/user-attachments/assets/1c3b6dc2-9acd-44fe-927d-31de3427639f" width="75" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-cpp"><img src="https://github.com/user-attachments/assets/36de8512-acfd-44fb-bb1f-b7c793a3f926" width="45" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-php"><img src="https://github.com/user-attachments/assets/e8797843-3f61-4fa9-a155-ab0b21fb3858" width="52" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-java"><img src="https://github.com/user-attachments/assets/a3d923f6-4fec-4c07-ac50-e20da6370911" width="50" height="30"></a>
+<a href="https://github.com/2captcha/2captcha-csharp"><img src="https://github.com/user-attachments/assets/f4d449de-780b-49ed-bb0a-b70c82ec4b32" width="38" height="30"></a>
 
-Это самый простой способ быстро интегрировать [2Captcha] в ваш код и автоматизировать решение любого типа капчи.
+# Ruby 2Captcha API Client (captcha solver)
 
-Ruby-клиент для API 2Captcha.
-
-- [Установка](#установка)
-- [Настройка](#настройка)
-    - [Опции экземпляра клиента](#опции-экземпляра-клиента)
-- [Решение капчи](#решение-капчи)
-  - [Обычная капча](#обычная-капча)
-  - [Текстовая капча](#текстовая-капча)
-  - [reCAPTCHA v2](#recaptcha-v2)
-  - [reCAPTCHA v3](#recaptcha-v3)
-  - [FunCaptcha](#funcaptcha)
-  - [GeeTest](#geetest)
-  - [hCaptcha](#hcaptcha)
-  - [KeyCaptcha](#keycaptcha)
-  - [Capy](#capy)
-  - [Grid](#grid)
-  - [Canvas](#canvas)
-  - [ClickCaptcha](#clickcaptcha)
-  - [Rotate](#rotate)
-  - [AmazonWAF](#amazon-waf)
-  - [CloudflareTurnstile](#cloudflare-turnstile)
-  - [Lemin Cropped Captcha](#lemin-cropped-captcha)
-  - [GeeTest V4](#geetest-v4)
-  - [Аудио](#audio)
-  - [CyberSiARA](#cybersiara)
-  - [DataDome](#datadome)
-  - [MTCaptcha](#mtcaptcha)
-  - [Friendly captcha](#friendly-captcha)
-  - [Cutcaptcha](#cutcaptcha)
-- [Другие методы](#другие-методы)
-  - [send / get_result](#send--get_result)
-  - [Баланс](#баланс)
-  - [Отчет](#отчет)
-- [Прокси](#прокси)
-- [Обработка ошибок](#обработка-ошибок)
+Это самый простой способ быстро интегрировать [2Captcha] в ваш код и автоматизировать решение любого типа капчи.
+Примеры API-запросов для различных типов капч доступны на странице [Ruby captcha solver](https://2captcha.com/lang/ruby).
+
+- [Ruby 2Captcha API Client (captcha solver)](#ruby-2captcha-api-client-captcha-solver)
+  - [Установка](#установка)
+  - [Настройка](#настройка)
+      - [Опции экземпляра клиента](#опции-экземпляра-клиента)
+  - [Решение капчи](#решение-капчи)
+    - [Обычная капча](#обычная-капча)
+    - [Текстовая капча](#текстовая-капча)
+    - [reCAPTCHA v2](#recaptcha-v2)
+    - [reCAPTCHA v3](#recaptcha-v3)
+    - [FunCaptcha](#funcaptcha)
+    - [GeeTest](#geetest)
+    - [GeeTest V4](#geetest-v4)
+    - [KeyCaptcha](#keycaptcha)
+    - [Capy](#capy)
+    - [Grid](#grid)
+    - [Canvas](#canvas)
+    - [ClickCaptcha](#clickcaptcha)
+    - [Rotate](#rotate)
+    - [Amazon WAF](#amazon-waf)
+    - [Cloudflare Turnstile](#cloudflare-turnstile)
+    - [Lemin Cropped Captcha](#lemin-cropped-captcha)
+    - [Распознавание аудио](#распознавание-аудио)
+    - [CyberSiARA](#cybersiara)
+    - [DataDome](#datadome)
+    - [MTCaptcha](#mtcaptcha)
+    - [Friendly captcha](#friendly-captcha)
+    - [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)
+  - [Другие методы](#другие-методы)
+    - [send / get_result](#send--get_result)
+    - [Баланс](#баланс)
+    - [Отчет](#отчет)
+  - [Прокси](#прокси)
+  - [Обработка ошибок](#обработка-ошибок)
+  - [Примеры](#примеры)
+- [Свяжитесь с нами](#свяжитесь-с-нами)
+- [Присоединяйтесь к команде 👪](#join-the-team)
+- [Лицензия](#лицензия)
+  - [Графика и товарные знаки](#графика-и-товарные-знаки)
 
 ## Установка
 Автоматическая установка гема с помощью Bundler. Добавьте следующую строку в ваш Gemfile:
@@ -62,7 +89,7 @@ gem install ruby-2captcha
 
 Описание всех необходимых параметров для настройки установленного гема.
 
-Экземпляр класса Api2Captcha можно создать следующим образом:
+Экземпляр класса `Api2Captcha` можно создать следующим образом:
 
 ```ruby
 require 'api_2captcha'
@@ -70,7 +97,7 @@ require 'api_2captcha'
 client =  Api2Captcha.new("YOUR_API_KEY")
 ```
 ### Опции экземпляра клиента
-У вас также есть возможность настроить некоторые параметры экземпляра Api2Captcha:
+У вас также есть возможность настроить некоторые параметры экземпляра `Api2Captcha`:
 
 ```ruby
 client.soft_id(123)
@@ -80,28 +107,34 @@ client.default_timeout(120)
 client.polling_interval(10)
 ```
 
-**ВАЖНО**: после определения обратного вызова для экземпляра , все методы возвращают только идентификатор капчи и НЕ запрашивают результат у API. Результат будет отправлен на URL обратного вызова. Чтобы получить ответ вручную, используйте метод get_result.
+>  [!IMPORTANT]
+> После определения обратного вызова для экземпляра, все методы возвращают только идентификатор капчи и НЕ запрашивают результат у API. Результат будет отправлен на URL обратного вызова.
+
+Чтобы получить ответ вручную, используйте метод [get_result](#send--get_result).
 
 ## Решение капчи
-При отправке любой капчи, основанной на изображении, вы можете предоставить дополнительные параметры, чтобы помочь работникам 2Captcha правильно ее решить.
+При отправке любой капчи, основанной на изображении, вы можете предоставить дополнительные параметры, чтобы помочь работникам 2Captcha правильно её решить.
 
 ### Параметры капчи
 
-| Параметр            | Значение по умолчанию | Описание                                                                                                                   |
-|-------------------|---------------|-------------------------------------------------------------------------------------------------------------------------------|
-| numeric           | 0             | Определяет, содержит ли капча числа или другие символы [подробнее см. в документации по API](https://2captcha.com/2captcha-api#solving_normal_captcha)                              |
-| min_len           | 0             |  Минимальная длина ответа length                                                                                                         |
-| max_len           | 0             | Максимальная длина ответа length                                                                                                         |
-| phrase            | 0             | Определяет, содержит ли ответ несколько слов или нет                                                                          |
-| case_sensitive    | 0             | Определяет, учитывается ли регистр в ответе                                                                                         |
-| calc              | 0             | Определяет, требуется ли вычисление в решении капчи                                                                                           |
+| Параметр          | Значение по умолчанию | Описание                                                                                                   |
+|-------------------|---------------|--------------------------------------------------------------------------------------------------------------------|
+| numeric           | 0             | Определяет, содержит ли капча числа или другие символы [подробнее см. в документации по API](https://2captcha.com/2captcha-api#solving_normal_captcha) |
+| min_len           | 0             | Минимальная длина ответа length                                                                                    |
+| max_len           | 0             | Максимальная длина ответа length                                                                                   |
+| phrase            | 0             | Определяет, содержит ли ответ несколько слов или нет                                                               |
+| case_sensitive    | 0             | Определяет, учитывается ли регистр в ответе                                                                        |
+| calc              | 0             | Определяет, требуется ли вычисление в решении капчи                                                                |
 | lang              | -             | Определяет язык капчи, см. [список поддерживаемых языков](https://2captcha.com/2captcha-api#language)                                                          |
-| hint_image        | -             | Изображение с подсказкой, показываемое работникам с капчей, переведенное из параметра API instructionsimg                          |
-| hint_text         | -             | Подсказка или текст задания, показываемые работникам с капчей                                                                            |
+| hint_image        | -             | Изображение с подсказкой, показываемое работникам с капчей, переведенное из параметра API instructionsimg          |
+| hint_text         | -             | Подсказка или текст задания, показываемые работникам с капчей                                                      |
 
 Ниже вы найдете основные примеры для каждого типа капчи. Ознакомьтесь с кодом ниже.
 
 ### Обычная капча
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_normal_captcha)</sup>
+
 Для обхода обычной капчи (искаженный текст на картинке) используйте следующий метод. Этот метод также может использоваться для распознавания любого текста на картинке.
 
 ```ruby
@@ -111,8 +144,11 @@ result = client.normal({
   image: 'https://site-with-captcha.com/path/to/captcha.jpg'
 })
 ```
+
 ### Текстовая капча
 
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_text_captcha)</sup>
+
 Этот метод может использоваться для обхода капчи, которая требует ответить на вопрос, представленный в явном виде.
 
 ```ruby
@@ -123,6 +159,9 @@ result = client.text({
 ```
 
 ### reCAPTCHA v2
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_recaptchav2_new)</sup>
+
 Используйте этот метод для решения reCAPTCHA v2 и получения токена для обхода защиты.
 
 ```ruby
@@ -134,6 +173,9 @@ result = client.recaptcha_v2({
 ```
 
 ### reCAPTCHA v3
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_recaptchav3)</sup>
+
 Этот метод предоставляет решение для reCAPTCHA v3 и возвращает токен.
 
 ```ruby
@@ -147,6 +189,9 @@ result = client.recaptcha_v3({
 ```
 
 ### FunCaptcha
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_funcaptcha_new)</sup>
+
 Метод решения FunCaptcha (Arkoselabs). Он возвращает токен.
 
 ```ruby
@@ -157,6 +202,9 @@ result = client.funcaptcha({
 ```
 
 ### GeeTest
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_geetest)</sup>
+
 Метод для решения головоломки GeeTest captcha. Он возвращает набор токенов в формате JSON.
 
 ```ruby
@@ -168,17 +216,24 @@ result = client.geetest({
 })
 ```
 
-### hCaptcha
-Метод решения hCaptcha. Он возвращает токен для обхода капчи.
+### GeeTest v4
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#geetest-v4)</sup>
+
+Используйте этот метод для решения GeeTest v4. Он возвращает ответ в формате JSON.
 
 ```ruby
-result = client.hcaptcha({
-  sitekey: '10000000-ffff-ffff-ffff-000000000001',
+result = client.geetest_v4({
+  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73',
   pageurl: 'https://www.site.com/page/'
 })
 ```
 
+
 ### KeyCaptcha
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_keycaptcha)</sup>
+
 Метод на основе токенов для решения KeyCaptcha.
 
 ```ruby
@@ -192,6 +247,9 @@ result = client.keycaptcha({
 ```
 
 ### Capy
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_capy)</sup>
+
 Метод основан на использовании токенов для обхода паззла Capy.
 
 ```ruby
@@ -203,21 +261,27 @@ result = client.capy({
 ```
 
 ### Grid
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#grid)</sup>
+
 Метод сетки изначально называется методом Old ReCaptcha V2. Этот метод может быть использован для обхода любого типа капчи, где вы можете применить сетку к изображению и необходимо кликнуть по определенным ячейкам сетки. Он возвращает количество выбранных ячеек.
 
 ```ruby
 result = client.grid({
   image: 'path/to/captcha.jpg',
-  rows: 3,
-  cols: 3,
+  recaptcharows: 3,
+  recaptchacols: 3,
   previous_id: 0,
   lang: 'en',
-  hint_image: 'path/to/hint.jpg',
-  hint_text: 'Select all images with an Orange'
+  imginstructions: 'path/to/hint.jpg',
+  textinstructions: 'Select all images with an Orange'
 })
 ```
 
 ### Canvas
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#canvas)</sup>
+
 Метод Canvas может быть использован, когда вам необходимо нарисовать линию вокруг объекта на изображении. Он возвращает набор координат точек для рисования многоугольника.
 
 ```ruby
@@ -231,6 +295,9 @@ result = client.canvas({
 ```
 
 ### ClickCaptcha
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#coordinates)</sup>
+
 Метод ClickCaptcha возвращает координаты точек на изображении капчи. Может быть использован, если вам необходимо кликнуть по определенным точкам на изображении.
 
 ```ruby
@@ -243,6 +310,9 @@ result = client.coordinates({
 ```
 
 ### Rotate
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#solving_rotatecaptcha)</sup>
+
 Этот метод может быть использован для решения капчи, которая просит повернуть объект. В основном используется для обхода FunCaptcha. Он возвращает угол поворота.
 
 ```ruby
@@ -257,7 +327,10 @@ result = client.rotate({
 
 
 ### Lemin Cropped Captcha
-Используйте этот метод для решения задания hCaptcha. Он возвращает JSON-ответ с указанными значениями: ответ (answer) и идентификатор задания (challenge_id).
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#lemin)</sup>
+
+Используйте этот метод для решения задания Lemin. Он возвращает JSON-ответ с указанными значениями: ответ (answer) и идентификатор задания (challenge_id).
 
 ```ruby
 result = client.lemin({
@@ -270,6 +343,9 @@ result = client.lemin({
 
 
 ### Cloudflare Turnstile
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#turnstile)</sup>
+
 Используйте этот метод для решения задачи Cloudflare Turnstile. Он возвращает JSON с токеном.
 
 ```ruby
@@ -280,6 +356,9 @@ result = client.turnstile({
 ```
 
 ### Amazon WAF
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#amazon-waf)</sup>
+
 Используйте этот метод для решения Captcha Amazon WAF, также известного как AWS WAF Captcha, который является частью интеллектуальной защиты от угроз для Amazon AWS. Он возвращает JSON с токеном.
 
 ```ruby
@@ -293,27 +372,25 @@ result = client.amazon_waf({
 })
 ```
 
-### GeeTest v4
-Используйте этот метод для решения GeeTest v4. Он возвращает ответ в формате JSON.
+### Распознавание аудио
 
-```ruby
-result = client.geetest_v4({
-  captcha_id: 'e392e1d7fd421dc63325744d5a2b9c73',
-  pageurl: 'https://www.site.com/page/'
-})
-```
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#audio)</sup>
 
-### Audio
-Этот метод можно использовать для решения аудио-капчи.
+Этот метод можно использовать как для решения аудио капчи, так и для распознавания любой аудиозаписи. 
+
+Поддерживаемые языки: "en", "ru", "de", "el", "pt", "fr".
 
 ```ruby
 result = client.audio({
-  audio: 'path/to/audio.jpg',
+  audio: 'path/to/audio.mp3',
   lang: "en"
 })
 ```
 
 ### CyberSiARA
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#cybersiara)</sup>
+
 Метод решения CyberSiARA. Он возвращает токен для обхода капчи.
 
 ```ruby
@@ -324,8 +401,13 @@ result = client.cyber_siara({
 ```
 
 ### DataDome
-Метод решения DataDome вернет токен для обхода капчи.
-Чтобы решить капчу DataDome вы должны обязательно использовать прокси.
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#datadome)</sup>
+
+Метод решения DataDome вернет `cookies` для обхода капчи.
+
+> [!IMPORTANT]
+> Чтобы решить капчу DataDome вы должны обязательно использовать прокси. Рекомендуется использовать [резидентные прокси].
 
 ```ruby
 result = client.data_dome({
@@ -338,6 +420,9 @@ result = client.data_dome({
 
 
 ### MTCaptcha
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#mtcaptcha)</sup>
+
 Метод решения MTCaptcha. Он возвращает токен для обхода капчи.
 
 ```ruby
@@ -349,8 +434,14 @@ result = client.mt_captcha({
 
 
 ### Friendly captcha
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#friendly-captcha)</sup>
+
 Метод решения Friendly captcha. Он возвращает токен для обхода капчи.
 
+> [!IMPORTANT]
+> Чтобы успешно использовать полученный токен, виджет капчи не должен быть загружен на странице. Для этого необходимо прервать запрос к `/friendlycaptcha/...module.min.js` на странице. Если виджет капчи уже загружен на странице, существует высокая вероятность, что полученный токен не будет работать.
+
 ```ruby
 result = client.friendly({
   pageurl: "https://example.com",
@@ -358,8 +449,10 @@ result = client.friendly({
 })
 ```
 
-
 ### Cutcaptcha
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#cutcaptcha)</sup>
+
 Метод решения Cutcaptcha. Он возвращает токен для обхода капчи.
 
 ```ruby
@@ -370,6 +463,222 @@ result = client.cutcaptcha({
 })
 ```
 
+### Tencent
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#tencent)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи Tencent.
+```ruby
+result = client.tencent({
+  app_id: "197326679",
+  pageurl: "https://mysite.com/page/with/tencent"
+})
+```
+
+### atbCAPTCHA
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#atb-captcha)</sup>
+
+Основанный на токенах метод автоматизированного решения капчи atbCAPTCHA.
+```ruby
+result = client.atb_captcha({
+  app_id: "197326679",
+  api_server: "api.atb_captcha.com",
+  pageurl: "https://mysite.com/page/with/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"
+})
+```
 
 ## Другие методы
 
@@ -395,6 +704,9 @@ time.sleep(20)
 result = client.get_result(captcha_id)
 ```
 ### Баланс
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#additional-methods)</sup>
+
 Используйте этот метод, чтобы посмотреть баланс в вашем аккаунте.
 
 ```ruby
@@ -402,6 +714,9 @@ balance = client.get_balance
 ```
 
 ### Отчет
+
+<sup>[Описание метода API.](https://2captcha.com/2captcha-api#complain)</sup>
+
 Используйте этот метод для отправки отчета о правильном или неправильном ответе на капчу.
 
 ```ruby
@@ -411,7 +726,7 @@ client.report(captcha_id, False) # капча решена неправильн
 
 ## Прокси
 
-Вы можете передать свой прокси-сервер в качестве дополнительного аргумента для методов: recaptcha, funcaptcha, geetest, geetest v4, hcaptcha, keycaptcha, capy puzzle, lemin, turnstile, amazon waf, Cutcaptcha, Friendly captcha, MTCaptcha, DataDome, CyberSiARA и других. Передынный Прокси-сервер будет перенаправлен в API и будет использован для загрузки капчи.
+Вы можете передать свой прокси-сервер в качестве дополнительного аргумента для методов: recaptcha, funcaptcha, geetest, geetest v4, keycaptcha, capy puzzle, lemin, turnstile, amazon waf, Cutcaptcha, Friendly captcha, MTCaptcha, DataDome, CyberSiARA и других. Передынный Прокси-сервер будет перенаправлен в API и будет использован для загрузки капчи.
 
 У нас есть свои собственные прокси-серверы, которые мы можем вам предложить. [Купить резидентские прокси] чтобы избежать ограничений и блокировок. [Быстрый старт].
 
@@ -448,7 +763,32 @@ result = client.recaptcha_v2({
   end
 ```
 
+## Примеры
+
+Примеры решения поддерживаемых типов капчи находятся в директории [examples].
+
+## Свяжитесь с нами
+
+<a href="mailto:support@2captcha.com"><img src="https://github.com/user-attachments/assets/539df209-7c85-4fa5-84b4-fc22ab93fac7" width="80" height="30"></a>
+<a href="https://2captcha.com/support/tickets/new"><img src="https://github.com/user-attachments/assets/be044db5-2e67-46c6-8c81-04b78bd99650" width="81" height="30"></a>
+
+<h2 id='join-the-team'>Присоединяйтесь к команде 👪</h2>
+
+Есть много способов внести свой вклад, и разработка - лишь один из них! Найдите свою следующую работу. Открытые вакансии: AI experts, scrapers, developers, technical support, и многое другое! 😍
+
+<a href="mailto:job@2captcha.com"><img src="https://github.com/user-attachments/assets/36d23ef5-7866-4841-8e17-261cc8a4e033" width="80" height="30"></a>
+
+## Лицензия
+
+Код в этом репозитории лицензируется по лицензии MIT. Более подробную информацию см. в файле [LICENSE](./LICENSE).
+
+### Графика и товарные знаки
+
+Графика и товарные знаки, включенные в этот репозиторий, не подпадают под действие лицензии MIT. За разрешениями на использование этих материалов обращайтесь в <a href="mailto:support@2captcha.com">службу поддержки</a>.
+
 <!-- Shared links -->
 [2Captcha]: https://2captcha.com/
 [Купить резидентские прокси]: https://2captcha.com/proxy/residential-proxies
-[Быстрый старт]: https://2captcha.com/proxy?openAddTrafficModal=true
+[Быстрый старт]: https://2captcha.com/proxy?openAddTrafficModal=true
+[резидентные прокси]: https://2captcha.com/proxy/residential-proxies
+[examples]: ./examples/