added hCaptcha

Author: imagetyperz-api

example.rb

@@ -28,7 +28,7 @@ def test_api
   # submit to server and get the id
 
   d = {}
-  d['page_url'] = 'page_url_here'    # adding --capy to the end of this, will make captcha be a capy captcha instead of reCAPTCHA
+  d['page_url'] = 'page_url_here'    # add --capy or --hcaptcha at the end, to submit capy or hCaptcha
   d['sitekey'] = 'sitekey_here'
   # d['type'] = 3    # optional, defaults to 1
   # d['v3_min_score'] = 0.3          # min score to target when solving v3 - optional

readme.md

@@ -138,13 +138,33 @@ puts geetest_response
 
 Response will look like this: `{'challenge': '...', 'validate': '...', 'seccode': '...'}`
 
-## Capy
+## Capy & hCaptcha
 
-This captcha requires a `page_url` and `sitekey` in order to be solved by our system.
-Currently, in order to solve a capy captcha, you'll have to use the reCAPTCHA methods and only add `--capy` at the end of the `page_url`.
-Having that up, our system will pick it up as capy. Once workers have solved it, you'll have to use the reCAPTCHA retrieve endpoint, to get the response.
+This are two different captcha types, but both are similar to reCAPTCHA. They require a `pageurl` and `sitekey` for solving. hCaptcha is the newest one.
 
-**E.g** Original page url - `https://mysite.com`, capy page url `https://mysite.com--capy`
+### IMPORTANT
+For this two captcha types, the reCAPTCHA methods are used (explained above), except that there's one small difference.
+
+The `pageurl` parameter should have at the end of it `--capy` added for Capy captcha and `--hcaptcha` for the hCaptcha. This instructs our system it's a capy or hCaptcha. It will be changed in the future, to have it's own endpoints.
+
+For example, if you were to have the `pageurl` = `https://mysite.com` you would send it as `https://mysite.com--capy` if it's capy or `https://mysite.com--hcaptcha` for hCaptcha. Both require a sitekey too, which is sent as reCAPTCHA sitekey, and response is received as reCAPTCHA response, once again using the reCAPTCHA method.
+
+#### Example
+```ruby
+d = {}
+d['page_url'] = 'domain.com--capy'    # add --capy or --hcaptcha at the end, to submit capy or hCaptcha
+d['sitekey'] = 'sitekey_here'
+captcha_id = ita.submit_recaptcha d
+
+puts "Waiting for Capy to be solved ..."
+while ita.in_progress captcha_id  # while it"s still in progress
+sleep 10    # sleep for 10 seconds
+end
+
+# get the response and print it
+solution = ita.retrieve_recaptcha captcha_id    # retrieve response
+puts "Capy response: #{solution}"
+```
 
 ## Other methods/variables