Hcaptcha.ir یک سرویس تشخیص خودکار تصویر و CAPTCHA است. هدف اصلی Hcaptcha.ir حل کردن CAPTCHA های شما به روشی سریع و دقیق توسط هوش مصنوعی است، اما این سرویس فقط به حل CAPTCHA محدود نمی شود. می توانید هر تصویری را که هوش مصنوعی تشخیص دهد به متن تبدیل کنید.
مقدمه
ما یک API ارائه می دهیم که به شما امکان می دهد فرآیند را خودکار کنید و نرم افزار خود را با خدمات ما یکپارچه کنید.
چند مرحله ساده برای حل کپچا یا تشخیص تصویر وجود دارد:
- تصویر یا کپچای خود را به سرور ما ارسال کنید.
- شناسه منحصر به فرد درخواست خود را دریافت کنید.
- چرخه درخواست را شروع کنید که بررسی می کند آیا کار شما تکمیل شده است یا خیر.
- پاسخ را دریافت کنید.
هزینه ها
هزینه های ما بستگی به نوع کپچایی که می خواهید حل کنید و روش استفاده شده دارد. نرخ برای کپچای معمولی نیز به بار سرویس فعلی بستگی دارد.
نوع
|
برای هر 1000 کپچا
|
توضیحات
|
کپچای تصویر |
15 هزار تومان
|
هزینه انعطاف پذیر است و به بار فعلی سرویس بستگی دارد. |
ReCaptcha V2,V3... |
30 هزار تومان
|
هزینه انعطاف پذیر است و به بار فعلی سرویس بستگی دارد.
|
HCaptcha |
30 هزار تومان
|
هزینه انعطاف پذیر است و به بار فعلی سرویس بستگی دارد.
|
حل کپچا
فرآیند حل کپچا واقعا آسان است و اکثراً برای همه انواع کپچا یکسان است:
- کلید API خود را از صفحه تنظیمات حساب خود دریافت کنید. به هر کاربر یک نشانه احراز هویت منحصر به فرد داده می شود که ما آن را کلید API می نامیم. این یک رشته 32 کاراکتری است که به عنوان نمونه:
2abc234de56fab7c89012d34e56f6789
این کلید برای تمام درخواست های شما به سرور ما استفاده می شود.
- یک درخواست همراه پارامترهای مربوطه نوع کپچا با متد POST به آدرس API ما ارسال کنید:
http://api.hcaptcha.ir/in.php
- اگر مشکلی پیش نیاید، سرور شناسه کپچا یا کد خطا را برمی گرداند.
- ایجاد تایم اوت: 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 می پذیرد.
نمونه فرم ارسال
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 |
soft_id |
Integer |
No |
ID of software developer. Developers who integrated their software with AZcaptcha get reward: 10% of spendings of their software users. |
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 با روش جدید ما بسیار ساده است:
-
به کد عنصر در صفحه ای که ReCaptcha را پیدا کردید نگاه کنید.
-
www.google.com/recaptcha/api2/anchor یا data-sitekey را پیدا کنید
-
کپی کنید پارامتر k پارامتر پیوند (یا مقدارdata-sitekey پارامتر).
-
از طریق متد 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
-
اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند:OK|2122988149 پارامتر استفاده شد.
در غیر این صورت سرور یک را برمی گرداندerror code.
-
یک وقفه ایجاد کنید و بعد از 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 |
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. |
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:
-
ابتدا باید مطمئن شوید که وب سایت هدف واقعاً از ReCaptcha V3 استفاده می کند
اگر باید V3 وجود داشته باشد:
- هیچ کپچا و هیچ تصویری برای کلیک کردن وجود ندارد
- اسکریپت api.js با پارامتر render=sitekey در حال بارگیری است، برای مثال:
https://www.google.com/recaptcha/api.js?render=6Ld0KL0UABBBBCd2-aa00bbCCddeee1FfF2gHiJK
- آرایه مشتری از شی ___grecaptcha_cfg از شاخص استفاده می کند 100000: ___grecaptcha_cfg.clients[100000]
-
برای شروع حل 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 نیاز دارد. امتیاز بالاتر در بین کارگران بسیار نادر است.
-
با داشتن تمام پارامترهای لازم ذکر شده در بالا، می توانید درخواست را به API ما ارسال کنید.
-
ارسال با متد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/
-
اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند: OK|2122988149 or as JSON {"status":1,"request":"2122988149"} if json parameter was used.
-
یک تایم اوت 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
-
س از دریافت رمز از API ما، باید آن را به درستی در وب سایت مورد نظر استفاده کنید. بهترین راه برای درک این موضوع این است که وقتی به عنوان یک کاربر عادی عمل می کنید، درخواست های ارسال شده به سایت را بررسی کنید. اکثر مرورگرها دارای ابزار کنسول توسعه دهنده هستند که باید تب Network را بررسی کنید.
معمولا توکن با استفاده از درخواست POST ارسال می شود. می تواند g-recaptcha-response باشد درست مانند ReCaptcha V2 یا g-recaptcha-response-100000. می تواند پارامتر دیگری نیز باشد. بنابراین باید درخواستها را بررسی کنید و متوجه شوید که رمز دقیقاً چگونه ارسال میشود. سپس باید درخواست خود را بر اساس آن تنظیم کنید.
-
اکنون وقتی توکن را با موفقیت ارسال کردید، می توانید به ما بگویید که آیا کار کرده است یا نه. در غیر این صورت، ما پولی را که برای این توکن خرج کردهاید بازپرداخت میکنیم. اگر با موفقیت پذیرفته شد، کارگری را که این کپچا را حل کرده است به عنوان حل کننده اولویت برای شما تعیین می کنیم. علاوه بر این، ما آماری در مورد راه حل 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 بسیار ساده است:
-
مقدار پارامتر data-sitekey را در کد منبع صفحه پیدا کنید.
-
ارسال با متد 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
-
اگر همه چیز خوب باشد، سرور شناسه کپچای شما را به صورت متن ساده برمی گرداند، مانند: OK|2122988149 or as JSON {"status":1,"request":"2122988149"} if json parameter was used.
-
یک وقفه 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