add friendly captcha fixes #30 (#31)

Author: kratzky

README.md

@@ -11,7 +11,7 @@
 The easiest way to quickly integrate [2Captcha] into your code to automate solving of any types of captcha.
 Examples of API requests for different captcha types are available on the [C# captcha solver](https://2captcha.com/lang/csharp) page.
 
-- [C# Module for 2Captcha API (captcha solver)](#c-module-for-2captcha-api-captcha-solver) 
+- [C# Module for 2Captcha API (captcha solver)](#c-module-for-2captcha-api-captcha-solver)
   - [Installation](#installation)
   - [Configuration](#configuration)
     - [TwoCaptcha instance options](#twocaptcha-instance-options)
@@ -37,16 +37,17 @@ Examples of API requests for different captcha types are available on the [C# ca
     - [Lemin](#lemin)
     - [Turnstile](#turnstile)
     - [AmazonWaf](#amazonwaf)
+    - [Friendly Captcha](#friendly-captcha)
   - [Other methods](#other-methods)
     - [send / getResult](#send--getresult)
     - [balance](#balance)
     - [report](#report)
   - [Proxies](#proxies)
   - [Error handling](#error-handling)
-- [Get in touch](#get-in-touch)
-- [Join the team 👪](#join-the-team-)
+  - [Get in touch](#get-in-touch)
+  - [Join the team 👪](#join-the-team-)
 - [License](#license)
-  - [Graphics and Trademarks](#graphics-and-trademarks)
+    - [Graphics and Trademarks](#graphics-and-trademarks)
 
 ## Installation
 Install nuget package from [nuget]
@@ -343,6 +344,15 @@ captcha.SetContext("test_iv");
 captcha.SetIV("test_context");
 ```
 
+### Friendly Captcha
+Use this method to solve Friendly Captcha. Returns a token to bypass the captcha.
+
+```csharp
+FriendlyCaptcha captcha = new FriendlyCaptcha();
+captcha.SetSiteKey("2FZFEVS1FZCGQ9");
+captcha.SetUrl("https://example.com");
+```
+
 
 ## Other methods
 

TwoCaptcha.Examples/FriendlyCaptchaExample.cs

@@ -0,0 +1,28 @@
+using System;
+using System.Linq;
+using TwoCaptcha.Captcha;
+
+namespace TwoCaptcha.Examples
+{
+    public class FriendlyCaptchaExample
+    {
+        public void Main()
+        {
+            TwoCaptcha solver = new TwoCaptcha("YOUR_API_KEY");
+
+            FriendlyCaptcha captcha = new FriendlyCaptcha();
+            captcha.SetSiteKey("2FZFEVS1FZCGQ9");
+            captcha.SetUrl("https://example.com");
+
+            try
+            {
+                solver.Solve(captcha).Wait();
+                Console.WriteLine("Captcha solved: " + captcha.Code);
+            }
+            catch (AggregateException e)
+            {
+                Console.WriteLine("Error occurred: " + e.InnerExceptions.First().Message);
+            }
+        }
+    }
+}

TwoCaptcha.Tests/FriendlyCaptchaTest.cs

@@ -0,0 +1,27 @@
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using NUnit.Framework;
+using TwoCaptcha.Captcha;
+
+namespace TwoCaptcha.Tests
+{
+    [TestFixture]
+    public class FriendlyCaptchaTest : AbstractWrapperTestCase
+    {
+        [Test]
+        public async Task TestAllOptions()
+        {
+            FriendlyCaptcha captcha = new FriendlyCaptcha();
+            captcha.SetSiteKey("2FZFEVS1FZCGQ9");
+            captcha.SetUrl("https://www.site.com/page/");
+
+            var parameters = new Dictionary<string, string>();
+            parameters["method"] = "friendly_captcha";
+            parameters["sitekey"] = "2FZFEVS1FZCGQ9";
+            parameters["pageurl"] = "https://www.site.com/page/";
+            parameters["soft_id"] = "4582";
+
+            await CheckIfCorrectParamsSendAndResultReturned(captcha, parameters);
+        }
+    }
+}

TwoCaptcha/Captcha/FriendlyCaptcha.cs

@@ -0,0 +1,20 @@
+namespace TwoCaptcha.Captcha
+{
+    public class FriendlyCaptcha : Captcha
+    {
+        public FriendlyCaptcha() : base()
+        {
+            parameters["method"] = "friendly_captcha";
+        }
+
+        public void SetSiteKey(string siteKey)
+        {
+            parameters["sitekey"] = siteKey;
+        }
+
+        public void SetUrl(string url)
+        {
+            parameters["pageurl"] = url;
+        }
+    }
+}