Hcaptcha.ir یک سرویس تشخیص خودکار تصویر و CAPTCHA است. هدف اصلی Hcaptcha.ir حل کردن CAPTCHA های شما به روشی سریع و دقیق توسط هوش مصنوعی است، اما این سرویس فقط به حل CAPTCHA محدود نمی شود. می توانید هر تصویری را که هوش مصنوعی تشخیص دهد به متن تبدیل کنید.

مقدمه

ما یک API ارائه می دهیم که به شما امکان می دهد فرآیند را خودکار کنید و نرم افزار خود را با خدمات ما یکپارچه کنید.

چند مرحله ساده برای حل کپچا یا تشخیص تصویر وجود دارد:

  1. تصویر یا کپچای خود را به سرور ما ارسال کنید.
  2. شناسه منحصر به فرد درخواست خود را دریافت کنید.
  3. چرخه درخواست را شروع کنید که بررسی می کند آیا کار شما تکمیل شده است یا خیر.
  4. پاسخ را دریافت کنید.

هزینه ها

هزینه های ما بستگی به نوع کپچایی که می خواهید حل کنید و روش استفاده شده دارد. نرخ برای کپچای معمولی نیز به بار سرویس فعلی بستگی دارد.

نوع
برای هر 1000 کپچا توضیحات
کپچای تصویر 15 هزار تومان
هزینه انعطاف پذیر است و به بار فعلی سرویس بستگی دارد.
ReCaptcha V2,V3... 30 هزار تومان
هزینه انعطاف پذیر است و به بار فعلی سرویس بستگی دارد.
HCaptcha 30 هزار تومان
هزینه انعطاف پذیر است و به بار فعلی سرویس بستگی دارد.


حل کپچا

فرآیند حل کپچا واقعا آسان است و اکثراً برای همه انواع کپچا یکسان است:

  1. کلید API خود را از صفحه تنظیمات حساب خود دریافت کنید. به هر کاربر یک نشانه احراز هویت منحصر به فرد داده می شود که ما آن را کلید API می نامیم. این یک رشته 32 کاراکتری است که به عنوان نمونه:
    2abc234de56fab7c89012d34e56f6789
    این کلید برای تمام درخواست های شما به سرور ما استفاده می شود.
  2. یک درخواست همراه پارامترهای مربوطه نوع کپچا با متد POST به آدرس API ما ارسال کنید:

     http://api.hcaptcha.ir/in.php

  3. اگر مشکلی پیش نیاید، سرور شناسه کپچا یا کد خطا را برمی گرداند.
  4. ایجاد تایم اوت:  5 ثانیه.
  5. برای دریافت نتیجه، درخواست با متد GET را به آدرس API ما ارسال کنید: http://api.hcaptcha.ir/res.php.
    اگر کپتچا از قبل حل شده باشد، سرور پاسخ را با فرمت مربوط به نوع کپچای شما برمی گرداند.
    به‌طور پیش‌فرض، پاسخ‌ها به صورت متن ساده بازگردانده می‌شوند: OK| پاسخ شما. اما در صورت استفاده از پارامتر json، پاسخ را می توان به صورت JSON {"status":1,"request":"TEXT"} برگرداند.
    اگر کپچا هنوز حل نشده باشد، سرور نتیجه CAPPCHA_NOT_READY را برمی گرداند. درخواست خود را هر 5 ثانیه تکرار کنید.
    اگر مشکلی رخ دهد سرور یک کد خطا برمی گرداند.

کپچای تصویر

کپچای معمولی تصویری است که حاوی متن تحریف شده، اما قابل خواندن توسط انسان است. برای حل کپچا کاربر باید متن را در تصویر تشخیص دهد.

برای حل کپچا با سرویس ما، باید تصویر را با درخواست متد POST به آدرس API ما ارسال کنید:

 http://api.hcaptcha.ir/in.php

سرور تصاویر را در قالب base64 می پذیرد.


نمونه فرم ارسال

                        
                            
                                <form method="post" action="http://api.hcaptcha.ir/in.php">
                                    <input type="hidden" name="method" value="base64"> Your key: 
                                    <input type="text" name="key" value="YOUR_APIKEY"> The CAPTCHA file body in base64 format: <textarea name="body">BASE64_FILE</textarea>
                                    <input type="submit" value="Upload and get the ID">
                                </form>
                            
                        
                    

YOUR_APIKEY کلید API شماست.

BASE64_FILE بدنه تصویر با کدگذاری base64 است.

شما می توانید پارامترهای اضافی را با درخواست خود ارائه دهید تا مشخص کنید که چه نوع کپچایی را ارسال می کنید و به سرور کمک کنید تا کپچای شما را به درستی حل کنند. لیست کامل پارامترها را می توانید در جدول زیر مشاهده کنید.

اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند: OK|2122988149 یا به عنوان JSON {"status":1,"request":"2122988149"} در صورت استفاده از پارامتر json.

اگر مشکلی رخ دهد سرور یک خطا برمی گرداند.

یک بازه زمانی 5 ثانیه ای ایجاد کنید و یک درخواست HTTP GET را به URL API ما ارسال کنید:

 http://api.hcaptcha.ir/res.php 

با ارائه شناسه کپچا. لیست پارامترها در جدول زیر آمده است.


اگر همه چیز خوب باشد و کپچای شما حل شده باشد، سرور پاسخ را به صورت متن ساده برمی گرداند، مانند: OK|TEXT یا به صورت JSON {"status":1,"request":"TEXT"} اگر از پارامتر json استفاده شده باشد.

در غیر این صورت سرور CAPCHA_NOT_READY را برمی گرداند که به این معنی است که کپچای شما هنوز حل نشده است. فقط درخواست خود را در 5 ثانیه تکرار کنید.

اگر مشکلی رخ دهد سرور یک خطا برمی گرداند.

List of POST request parameters for http://api.hcaptcha.ir/in.php

POST parameter Type Required Description
key String Yes your API key
method String Yes post - defines that you're sending an image with multipart form
base64 - defines that you're sending a base64 encoded image
body string Yes If method is base64 , requite body param
file file Yes If method is post , requite file upload param
textinstructions String
Max 140 characters
Endcoding: UTF-8
No textinstructions= contact support if you need special config captcha banking,scbeasy,game captcha...
imginstructions Image
Max 100x100px, 25 kB
No Image will be shown to worker to help him to solve the captcha correctly.
Server accepts images from multipart form or base64-encoded.
header_acao Integer
Default: 0
No 0 - disabled
1 - enabled.
If enabled in.php will include Access-Control-Allow-Origin:* header in the response.
Used for cross-domain AJAX requests in web applications.
pingback String No URL for pingback (callback) response that will be sent when captcha is solved.
URL should be registered on the server. More info here.
json Integer
Default: 0
No 0 - server will send the response as plain text
1 - tells the server to send the response as JSON

List of GET request parameters for http://api.hcaptcha.ir/res.php

GET parameter Type Required Description
key String Yes your API key
action String Yes get - get the asnwer for your captcha
id Integer Yes ID of captcha returned by in.php.
json Integer
Default: 0
No 0 - server will send the response as plain text
1 - tells the server to send the response as JSON
header_acao Integer
Default: 0
No 0 - disabled
1 - enabled.
If enabled res.php will include Access-Control-Allow-Origin:* header in the response.
Used for cross-domain AJAX requests in web applications.

نمونه پاسخ:

                        http://api.hcaptcha.ir/res.php?key=2abc234de56fab7c89012d34e56f6789&action=get&id=2122988149
                        

ReCaptcha V2

ReCaptcha V2 که با نام من ربات نیستم نیز شناخته می شود reCaptcha یک نوع بسیار محبوب از کپچا است که شبیه به این است:

حل ReCaptcha V2 با روش جدید ما بسیار ساده است:

  1. به کد عنصر در صفحه ای که ReCaptcha را پیدا کردید نگاه کنید.

  2. www.google.com/recaptcha/api2/anchor یا data-sitekey را پیدا کنید

  3. کپی کنید پارامتر k پارامتر پیوند (یا مقدارdata-sitekey پارامتر).

  4. از طریق متد GET داده ها را به آدرس روبرو ارسال کنید: http://api.hcaptcha.ir/in.php با متد userrecaptcha و مقدار data-sitekey googlekey وآدرس صفحه را pageurl.

    نمونه آدرس:

                                    http://api.hcaptcha.ir/in.php?key=2abc234de56fab7c89012d34e56f6789&method=userrecaptcha&googlekey=6Le-wvkSVVABCPBMRTvw0Q4Muexq1bi0DJwx_mJ-&pageurl=http://mysite.com/page/with/recaptcha?appear=1&here=now
                                
  5. اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند:OK|2122988149 پارامتر استفاده شد.
    در غیر این صورت سرور یک را برمی گرداندerror code.

  6. یک وقفه ایجاد کنید و بعد از 15 تا 20 ثانیه ای یک درخواست جهت دریافت جواب ارسال کنیدHTTP GET درخواست به URL API ما: http://api.hcaptcha.ir/res.php برای گرفتن پاسخ
    The full list of parameters is in the table below.

    اگر کپچا حل شده باشد پاسخ به صورت ذیل برگردانده می شود

                                    03AHJ_Vuve5Asa4koK3KSMyUkCq0vUFCR5Im4CwB7PzO3dCxIo11i53epEraq-uBO5mVm2XRikL8iKOWr0aG50sCuej9bXx5qcviUGSm4iK4NC_Q88flavWhaTXSh0VxoihBwBjXxwXuJZ-WGN5Sy4dtUl2wbpMqAj8Zwup1vyCaQJWFvRjYGWJ_TQBKTXNB5CCOgncqLetmJ6B6Cos7qoQyaB8ZzBOTGf5KSP6e-K9niYs772f53Oof6aJeSUDNjiKG9gN3FTrdwKwdnAwEYX-F37sI_vLB1Zs8NQo0PObHYy0b0sf7WSLkzzcIgW9GR0FwcCCm1P8lB-50GQHPEBJUHNnhJyDzwRoRAkVzrf7UkV8wKCdTwrrWqiYDgbrzURfHc2ESsp020MicJTasSiXmNRgryt-gf50q5BMkiRH7osm4DoUgsjc_XyQiEmQmxl5sqZP7aKsaE-EM00x59XsPzD3m3YI6SRCFRUevSyumBd7KmXE8VuzIO9lgnnbka4-eZynZa6vbB9cO3QjLH0xSG3-egcplD1uLGh79wC34RF49Ui3eHwua4S9XHpH6YBe7gXzz6_mv-o-fxrOuphwfrtwvvi2FGfpTexWvxhqWICMFTTjFBCEGEgj7_IFWEKirXW2RTZCVF0Gid7EtIsoEeZkPbrcUISGmgtiJkJ_KojuKwImF0G0CsTlxYTOU2sPsd5o1JDt65wGniQR2IZufnPbbK76Yh_KI2DY4cUxMfcb2fAXcFMc9dcpHg6f9wBXhUtFYTu6pi5LhhGuhpkiGcv6vWYNxMrpWJW_pV7q8mPilwkAP-zw5MJxkgijl2wDMpM-UUQ_k37FVtf-ndbQAIPG7S469doZMmb5IZYgvcB4ojqCW3Vz6Q
                                

    اگر کپچا حل نشده باشد سرور پاسخ CAPCHA_NOT_READY را بر میگرداند و شما 5 ثانیه دیگه جهت پاسخ تلاش نمایید.

List of GET/POST request parameters for http://api.hcaptcha.ir/in.php

Parameter Type Required Description
key String Yes your API key
method String Yes userrecaptcha - defines that you're sending a ReCaptcha V2 with new method
googlekey String Yes Value of k or data-sitekey parameter you found on page
pageurl String Yes Full URL of the page where you see the ReCaptcha
invisible Integer
Default: 0
No 1 - means that ReCaptcha is invisible. 0 - normal ReCaptcha.
data-s string No Value of data-s parameter you found on page. Curenttly applicable for Google Search and other Google services.
cookies string No Your cookies that will be passed to our worker who solve the captha. We also return worker's cookies in the response if you use json=1.
Format: KEY:Value, separator: semicolon, example: KEY1:Value1;KEY2:Value2;
header_acao Integer
Default: 0
No 0 - disabled
1 - enabled.
If enabled in.php will include Access-Control-Allow-Origin:* header in the response.
Used for cross-domain AJAX requests in web applications. Also supported by res.php.
pingback String No URL for pingback (callback) response that will be sent when captcha is solved.
URL should be registered on the server. More info here.
json Integer
Default: 0
No 0 - server will send the response as plain text
1 - tells the server to send the response as JSON
proxy String No Format: login:password@123.123.123.123:3128
You can find more info about proxies here.
proxytype String No Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5.
cookie String No Additional cookies which we must use during interaction with target page or Google.
Format: cookiename1=cookievalue1; cookiename2=cookievalue2
useragent String No Browser's User-Agent which is used in emulation. It is required that you use a signature of a modern browser, otherwise Google will ask you to "update your browser".

List of GET request parameters for http://api.hcaptcha.ir/res.php

GET parameter Type Required Description
key String Yes your API key
action String Yes get - get the asnwer for your captcha
id Integer Yes ID of captcha returned by in.php.
json Integer
Default: 0
No 0 - server will send the response as plain text
1 - tells the server to send the response as JSON

Request URL example:

                        http://api.hcaptcha.ir/res.php?key=2abc234de56fab7c89012d34e56f6789&action=get&id=2122988149
                    

ReCaptcha V3

ReCaptcha V3 جدیدترین نوع کپچای گوگل است. هیچ چالشی ندارد بنابراین نیازی به تعامل کاربر نیست. در عوض از یک رتبه بندی "انسانیت" - امتیاز استفاده می کند.

ReCaptcha V3 از نظر فنی کاملاً شبیه ReCaptcha V2 است: مشتری یک توکن از ReCaptcha API دریافت می کند که سپس در یک درخواست POST به وب سایت مورد نظر ارسال می شود و از طریق ReCaptcha API تأیید می شود.

اکنون تفاوت این است که ReCaptcha API رتبه‌بندی کاربر را که تشخیص می‌دهد یک انسان واقعی است یا یک ربات، برمی‌گرداند. این رتبه بندی نمره نامیده می شود و می تواند عددی از 0.1 تا 0.9 باشد. این امتیاز به وب سایت منتقل می شود و سپس تصمیم می گیرد با درخواست کاربر چه کاری انجام دهد.

همچنین یک پارامتر جدید action وجود دارد که به شما امکان می دهد اقدامات کاربر در وب سایت را متفاوت پردازش کنید. پس از تأیید رمز ReCaptcha API نام کاربر اقدام انجام شده را برمی گرداند.

رویکرد ما برای حل ReCaptcha V3
ما آزمایش‌های زیادی انجام داده‌ایم و متوجه شده‌ایم که اگر کاربر در برخی از وب‌سایت‌ها امتیاز 0.1 بگیرد، احتمالاً در وب‌سایت‌های دیگر نیز همین امتیاز را خواهد گرفت.

ما در حال شناسایی امتیازات کارگران خود هستیم. سپس وقتی درخواستی برای حل ReCaptcha V3 با حداقل رتبه min_score دریافت کردیم، کپچا را به کارگر با رتبه درخواستی یا بالاتر ارسال می کنیم. اکثر درخواست ها رتبه درخواستی را در وب سایت های هدفمند با ReCaptcha V3 دریافت می کنند.

نحوه حل ReCaptcha V3 با استفاده از hcaptcha:

  1. ابتدا باید مطمئن شوید که وب سایت هدف واقعاً از ReCaptcha V3 استفاده می کند

    اگر باید V3 وجود داشته باشد:

    • هیچ کپچا و هیچ تصویری برای کلیک کردن وجود ندارد
    • اسکریپت api.js با پارامتر render=sitekey در حال بارگیری است، برای مثال:
      https://www.google.com/recaptcha/api.js?render=6Ld0KL0UABBBBCd2-aa00bbCCddeee1FfF2gHiJK
    • آرایه مشتری از شی ___grecaptcha_cfg از شاخص استفاده می کند 100000: ___grecaptcha_cfg.clients[100000]

  2. برای شروع حل ReCaptcha V3 با استفاده از API ما ابتدا باید سه پارامتر را پیدا کنید:

    sitekey - این پارامتر را می توان از URI api.js به عنوان مقدار پارامتر render بدست آورد. همچنین می‌توان آن را در داخل URI iframe با ReCaptcha، در کد جاوا اسکریپت وب‌سایت که تابع grecaptcha.execute را فراخوانی می‌کند یا در شی پیکربندی ___grecaptcha_cfg یافت.

    action - شما باید این کد جاوا اسکریپت بازرسی وب سایت را که به دنبال فراخوانی تابع grecaptcha.execute است، پیدا کنید. مثال: grecaptcha.execute('6Ld0KL0UABBBBCd2-aa00bbCCddeee1FfF2gHiJK', {action: do_something}).
    گاهی اوقات پیدا کردن آن واقعاً سخت است و باید تمام فایل‌های js را که توسط وب‌سایت بارگذاری شده‌اند جستجو کنید. همچنین ممکن است سعی کنید مقدار پارامتر اقدام را در شیء پیکربندی ___grecaptcha_cfg بیابید، اما معمولاً تعریف نشده است. در این صورت باید با grecaptcha.execute تماس بگیرید و کد جاوا اسکریپت را بررسی کنید. اگر نمی توانید آن را پیدا کنید، سعی کنید از مقدار پیش فرض "تأیید" استفاده کنید - اگر اقدامی در درخواست خود ارائه نکنید API ما از آن استفاده می کند.

    pageurl - URL کامل صفحه ای که ReCaptcha V3 را می بینید.

    اکنون باید score مورد نیاز برای حل V3 را درک کنید. شما نمی توانید پیش بینی کنید که چه نمره ای برای وب سایتی که می خواهید در آن حل کنید قابل قبول است. فقط با آزمون و خطا می توان فهمید. کمترین امتیاز 0.1 به معنای "ربات" و بالاترین امتیاز 0.9 به معنای "انسان" است. اما اکثر سایت‌ها از آستانه‌های 0.2 تا 0.5 استفاده می‌کنند زیرا انسان‌های واقعی اغلب امتیاز پایینی دریافت می‌کنند. خدمات ما قادر به ارائه راه حل هایی است که به امتیاز 0.3 نیاز دارد. امتیاز بالاتر در بین کارگران بسیار نادر است.

  3. با داشتن تمام پارامترهای لازم ذکر شده در بالا، می توانید درخواست را به API ما ارسال کنید.

  4. ارسال با متدGET یا POST به آدرس API خود درخواست دهید:
    http://api.hcaptcha.ir/in.php
    با method که مقدار ان با userrecaptcha و version که مقدار آن v3 همرا با min_score مجموعه ای به امتیاز وب سایت نیاز دارد، sitekey در داخل googlekey پارامتر و URL صفحه کامل به عنوان مقدار برای pageurl. باید شامل شود action پارامتر به یا در غیر این صورت از مقدار پیش فرض استفاده خواهیم کرد verify.

    لیست پارامترهای درخواست زیر.

    نمونه آدرس ارسالی:

                                    http://api.hcaptcha.ir/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=userrecaptcha&version=v3&action=verify&min_score=0.3 &googlekey=6Ld0KL0UABBBBCd2-aa00bbCCddeee1FfF2gHiJK&pageurl=http://mysite.com/page/
                                
  5. اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند: OK|2122988149 or as JSON {"status":1,"request":"2122988149"} if json parameter was used.

  6. یک تایم اوت 10-15 ثانیه ای ایجاد کنید و یک را ارسال کنید HTTP GET درخواست به API ما http://api.hcaptcha.ir/res.php ارائه شناسه کپچا لیست پارامترها در جدول زیر.

    اگر همه چیز خوب باشد و کپچای شما حل شده باشد، سرور پاسخ را به صورت متن ساده یا به صورت JSON برمی گرداند. پاسخ یک نشانه مانند این است:

                                    03AHJ_Vuve5Asa4koK3KSMyUkCq0vUFCR5Im4CwB7PzO3dCxIo11i53epEraq-uBO5mVm2XRikL8iKOWr0aG50sCuej9bXx5qcviUGSm4iK4NC_Q88flavWhaTXSh0VxoihBwBjXxwXuJZ-WGN5Sy4dtUl2wbpMqAj8Zwup1vyCaQJWFvRjYGWJ_TQBKTXNB5CCOgncqLetmJ6B6Cos7qoQyaB8ZzBOTGf5KSP6e-K9niYs772f53Oof6aJeSUDNjiKG9gN3FTrdwKwdnAwEYX-F37sI_vLB1Zs8NQo0PObHYy0b0sf7WSLkzzcIgW9GR0FwcCCm1P8lB--gf50q5BMkiRH7osm4DoUgsjc_XyQiEmQmxl5sqZP7aKsaE-EM00x59XsPzD3m3YI6SRCFRUevSyumBd7KmXE8VuzIO9lgnnbka4-eZynZa6vbB9cO3QjLH0xSG3--o-fxrOuphwfrtwvvi2FGfpTexWvxhqWICMFTTjFBCEGEgj7_IFWEKirXW2RTZCVF0Gid7EtIsoEeZkPbrcUISGmgtiJkJ_KojuKwImF0G0CsTlxYTOU2sPsd5o1JDt65wGniQR2IZufnPbbK76Yh_KI2DY4cUxMfcb2fAXcFMc9dcpHg6f9wBXhUtFYTu6pi5LhhGuhpkiGcv6vWYNxMrpWJW_pV7q8mPilwkAP-zw5MJxkgijl2wDMpM-UUQ_k37FVtf-ndbQAIPG7S469doZMmb5IZYgvcB4ojqCW3Vz6Q
                                

    اگر کپچا هنوز حل نشده باشد، سرور این پیام را بر میگرداند CAPCHA_NOT_READY. و شما 5 ثانیه دیگر درخواست جدیدی برای پاسخ ارسال نمایید.

    می‌توانید پارامتر اضافی taskinfo=1 را همراه با json=1 ارائه دهید و API رمز را در قالب JSON با اطلاعات اضافی برمی‌گرداند:

    • user_check - شناسه که کپچا را حل کرده است.
    • user_score - امتیاز این کار.

    Sample request:

                                    http://api.hcaptcha.ir/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&taskinfo=1&json=1&id=2122988149
                                
  7. س از دریافت رمز از API ما، باید آن را به درستی در وب سایت مورد نظر استفاده کنید. بهترین راه برای درک این موضوع این است که وقتی به عنوان یک کاربر عادی عمل می کنید، درخواست های ارسال شده به سایت را بررسی کنید. اکثر مرورگرها دارای ابزار کنسول توسعه دهنده هستند که باید تب Network را بررسی کنید.

    معمولا توکن با استفاده از درخواست POST ارسال می شود. می تواند g-recaptcha-response باشد درست مانند ReCaptcha V2 یا g-recaptcha-response-100000. می تواند پارامتر دیگری نیز باشد. بنابراین باید درخواست‌ها را بررسی کنید و متوجه شوید که رمز دقیقاً چگونه ارسال می‌شود. سپس باید درخواست خود را بر اساس آن تنظیم کنید.

  8. اکنون وقتی توکن را با موفقیت ارسال کردید، می توانید به ما بگویید که آیا کار کرده است یا نه. در غیر این صورت، ما پولی را که برای این توکن خرج کرده‌اید بازپرداخت می‌کنیم. اگر با موفقیت پذیرفته شد، کارگری را که این کپچا را حل کرده است به عنوان حل کننده اولویت برای شما تعیین می کنیم. علاوه بر این، ما آماری در مورد راه حل V3 جمع آوری خواهیم کرد که به ما کمک می کند تا این نوع جدید کپچا را بیشتر بررسی کنیم و خدمات خود را بهتر کنیم.

    برای اینکه به ما اطلاع دهید کار می کند یا نه، لطفاً درخواست را با استفاده از API KeyCaptcha در پارامتر key با شناسه به http://api.hcaptcha.ir/res.php ارسال کنید. کپچا در پارامتر id و پارامتر action را نشان می‌دهد. اگر نشانه با موفقیت پذیرفته شد reportgood یا اگر نشانه محترمانه پذیرفته نشد reportbad است.

    نمونه درخواست:

                                    http://api.hcaptcha.ir/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=reportgood&id=2122988149 http://api.hcaptcha.ir/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=reportbad&id=2122988149&answer=YOURCORECTCAPTCHA 
                                

    مهم: شکایات مربوط به انواع کپچا حل شده با توکن در وب سایت نشان داده نمی شود. اما ما با هر گزارشی پیش می رویم و آمار را جمع آوری می کنیم. ما این ویژگی نمایش شکایت را در آینده اجرا خواهیم کرد.



List of GET/POST request parameters for http://api.hcaptcha.ir/in.php

Parameter Type Required Description
key String Yes your API key
method String Yes userrecaptcha — defines that you're sending a ReCaptcha
version String Yes v3 — defines that you're sending a ReCaptcha V3
googlekey String Yes Value of sitekey parameter you found on page
pageurl String Yes Full URL of the page where you see the ReCaptcha
action String
Default: verify
No Value of action parameter you found on page
min_score Integer
Default: 0.4
No The score needed for resolution. Currently it's almost impossible to get token with score higher than 0.3
header_acao Integer
Default: 0
No 0 — disabled
1 — enabled.
If enabled in.php will include Access-Control-Allow-Origin:*: header in the response.
Used for cross-domain AJAX requests in web applications. Also supported by res.php.
pingback String No URL for pingback (callback) response that will be sent when captcha is solved. URL should be registered on the server. More info here.
json Integer
Default: 0
No 0 — server will send the response as plain text
1 — tells the server to send the response as JSON
soft_id Integer No ID of software developer. Developers who integrated their software with azcaptcha get reward: 10% of spendings of their software users.
proxy String No Format: login:password@123.123.123.123:3128
You can find more info about proxies here.
proxytype String No Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5.

List of GET request parameters for http://api.hcaptcha.ir/res.php

GET parameter Type Required Description
key String Yes your API key
action String Yes get — get the asnwer for your captcha
reportgood — - report the asnwer was accepted
reportbad — - report the asnwer was declined
id Integer Yes ID of captcha returned by in.php.
json Integer
Default: 0
No 0 — server will send the response as plain text
1 — tells the server to send the response as JSON
taskinfo Integer
Default: 0
No 1 — server will return additional information regarding the captcha: ID and score of the worker who solved the captcha.
Should be used only with json=1
header_acao Integer
Default: 0
No 0 — disabled
1 — enabled.
If enabled res.php will include Access-Control-Allow-Origin:* header in the response.
Used for cross-domain AJAX requests in web applications.

hCaptcha

hCaptcha یک نوع کاملاً جدید از کپچا است که واقعاً شبیه ReCaptcha است و به شکل زیر است:

حل hCaptcha بسیار ساده است:

  1. مقدار پارامتر data-sitekey را در کد منبع صفحه پیدا کنید.

  2. ارسال با متد GET یا POST ارسال به Url: https://api.hcaptcha.ir/in.php با method hcaptcha و مقدار data-sitekey در مرحله قبل را به عنوان مقدار برای sitekey قرار دهید و آدرس کامل صفحه را برای پارامتر pageurl.
    شما می توانید لیست کامل پارامترها را در table below.

    Request URL example:

                                    https://api.hcaptcha.ir/in.php?key=1abc234de56fab7c89012d34e56fa7b8&method=hcaptcha&sitekey=10000000-ffff-ffff-ffff-000000000001&pageurl=http://mysite.com/register
                                
  3. اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند: OK|2122988149 or as JSON {"status":1,"request":"2122988149"} if json parameter was used.

  4. یک وقفه 5-20 ثانیه ای ایجاد کنید و سپس یک درخواست ارسال کنیدHTTP GET https://api.hcaptcha.ir/res.phpبرای دریافت جواب.

    اگر کپچا از قبل حل شده باشد، سرور به صورت متن ساده یا JSON پاسخ می‌دهد و توکن پاسخ را به شکل زیر برمی‌گرداند:

                                    P0_eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJwYXNza2V5IjoiNGQ3MTI5ZmUtOTQxZi00NGQ4LWI5MzYtMzAwZjUyMmM3Yzc2IiwiZXhwIjoxNTY4MTA3MjY4LCJzaGFyZF9pZCI6MzAyMzQ1NDg4fQ.yJuANPBc1uzCw9tW6CoLqiijBgh6zF00KdsnqaJtugg
                                

    اگ�� کپچا هنوز حل نشده باشد، سرور نتیجه CAPCHA_NOT_READY را برمی گرداند. درخواست خود را در 5 ثانیه تکرار کنید.

List of GET/POST request parameters for https://api.hcaptcha.ir/in.php

Parameter Type Required Description
key String Yes your API key
method String Yes hcaptcha - defines that you're sending hCaptcha
sitekey String Yes Value of data-sitekey parameter you found on page
pageurl String Yes Full URL of the page where you see the hCaptcha
header_acao Integer
Default: 0
No 0 - disabled
1 - enabled.
If enabled in.php will include Access-Control-Allow-Origin:* header in the response.
Used for cross-domain AJAX requests in web applications. Also supported by res.php.
pingback String No URL for pingback (callback) response that will be sent when captcha is solved.
URL should be registered on the server. More info here.
json Integer
Default: 0
No 0 - server will send the response as plain text
1 - tells the server to send the response as JSON
proxy String No Format: login:password@123.123.123.123:3128
You can find more info about proxies here.
proxytype String No Type of your proxy: HTTP, HTTPS, SOCKS4, SOCKS5.

List of GET request parameters for https://api.hcaptcha.ir/res.php

GET parameter Type Required Description
key String Yes your API key
action String Yes get - get the asnwer for your captcha
id Integer Yes ID of captcha returned by in.php.
json Integer
Default: 0
No 0 - server will send the response as plain text
1 - tells the server to send the response as JSON

Request URL example:

                        https://api.hcaptcha.ir/res.php?key=1abc234de56fab7c89012d34e56fa7b8&action=get&id=2122988149