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

مقدمه

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

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

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

هزینه ها

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

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


حل کپچا

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

  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