راهنمای توسعهدهندگان
گذر را به فرم خود وصل کن.
ابزار مرورگر یک توکن کوتاهمدت میسازد؛ سرور شما پیش از پردازش فرم، آن را اعتبارسنجی میکند.
۱. ثبت سایت و دریافت کلید
از پنل، نام سایت و دامنهٔ دقیق را ثبت کن. زیردامنهها مستقل هستند. کلید عمومی را در مرورگر و کلید محرمانه را فقط در تنظیمات سرور نگه دار.
ثبت اولین سایت۲. نصب ابزار و اعتبارسنجی
برای هر بار ارسال فرم، یک توکن تازه لازم است. مقدار hostname و action را در سرور ثابت نگه دار و از ورودی کاربر نگیر.
<form method="POST" action="/contact">
<!-- Your form fields -->
<div class="gozar-captcha"
data-sitekey="YOUR_SITE_KEY"
data-action="contact"></div>
<button type="submit">Send</button>
</form>
<script src="https://capcha.idsolutions.ir/widget.js" defer></script>۳. پاسخ اعتبارسنجی را بررسی کن
success: trueتوکن معتبر بود و مصرف شد؛ فرم میتواند پردازش شود.
400پاسخ نادرست، توکن منقضی یا استفادهٔ مجدد.
403کلید، دامنه یا دسترسی معتبر نیست.
429تلاشهای بیش از حد؛ مدتی صبر کن.
503سرویس در دسترس نیست؛ فرم را خودکار تأیید نکن.
رفتار نسخهٔ اولیه
- چالش تصویری: ۳ دقیقه اعتبار، یک تلاش برای هر تصویر.
- توکن تأیید: ۲ دقیقه اعتبار، قابل مصرف فقط یک بار.
- مجوز دموی فرم: ۱۰ دقیقه اعتبار و یک بار ارسال.
- محدودیت درخواست: حداکثر ۲۰ چالش در دقیقه برای هر ترکیب سایت و مبدأ شبکه.
- توکن و کلید محرمانه بهصورت هش در پایگاه داده نگهداری میشوند.
- گزارشها شامل وضعیت و زمان هستند؛ متن فرم دمو ذخیره نمیشود.
- رویدادها تا ۳۰ روز نگهداری میشوند؛ پنل بازهٔ ۷ روز اخیر را نشان میدهد.
- برای استفادهٔ تجاری، آزمون مقاومت، مسیر دسترسپذیر جایگزین و ارزیابی با ترافیک واقعی لازم است.
کلید محرمانه را گم کردی؟
از بخش «کلیدها و اتصال» کلید تازه بساز. کلید قبلی بلافاصله از اعتبار میافتد.