Checkify
JavaScript SDK v1.0.1

بدء سريع لمدة 5 دقائق

أضف Checkify إلى موقع الويب الخاص بك باستخدام معرف مرور واحد ونوع الطلب. لا يلزم إعداد المشغل اليدوي.

1. أنشئ موقعًا وانسخ معرف المرور الخاص بك

في تطبيق Checkify أو لوحة معلومات الأعمال، أنشئ موقعًا رقميًا وسجل المجال حيث سيتم تشغيل التضمين الخاص بك. Checkify يوفر تلقائيًا تصريحًا واحدًا لكل موقع (على سبيل المثال chk_live_...).

بالنسبة لاختبار وضع الحماية، استخدم تصريح اختبار ( chk_test_...) من موقع بيئة اختبار.

2. أضف مقتطف التضمين

والصقه في صفحتك. استبدل YOUR_PASS_ID واختر نوع الطلب.

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<div
  data-checkify-pass="YOUR_PASS_ID"
  data-checkify-request="human"
  data-checkify-text="Verify with Checkify"
></div>

3. ربط نموذج (اختياري)

لتسجيل الدخول أو الاشتراك أو الخروج أو نماذج الاتصال، اسمح لـ SDK بالتعامل مع الزر وحقل الرمز المميز المخفي وإرسال الحالة.

<form id="signup-form">
  <input type="email" name="email" required>
  <input type="hidden" id="checkify_token" name="checkify_token">
  <div id="checkify-button"></div>
  <button id="submit" type="button">Create account</button>
</form>

<script src="https://checkify.me/sdk/v1/checkify.min.js"></script>
<script>
  Checkify.bindForm('#signup-form', {
    passId: 'YOUR_PASS_ID',
    requestType: 'human',
    buttonTarget: '#checkify-button',
    submitButton: '#submit',
    hiddenInput: '#checkify_token'
  });
</script>

4. التحقق على الواجهة الخلفية لديك

يتلقى المتصفح رمزًا مميزًا فقط. تحقق دائمًا من جانب الخادم قبل السماح بالإجراء المحمي.

استخدم مفتاح موقعك API واتصل POST /v1/qr/results/verify باستخدام request_id من الحقل المخفي (قد تستمر عمليات التضمين القديمة في إرسال رمز الاستقصاء). راجع دليل التحقق من الخادم. For browser events and return URLs, see the embed API referenceللأحداث ومعالجة عنوان URL للإرجاع.

أنواع الطلب

نوع الطلب Server claim (required_claims) الاستخدام النموذجي
humanhuman_verifiedتقليل الروبوتات/البريد العشوائي
age_over_18age_over_1818+ محتوى أو الخروج
age_over_21age_over_2121+ منتج (كحول أمريكي، إلخ.)
age_over_25age_over_25عتبات عمرية أعلى

Use these request types in your embed (data-checkify-request or Checkify.bindForm). On your server, verify with the matching claim in required_claims.

ربط النطاق

يبدأ التضمين فقط من المجالات المسجلة على موقع Checkify الخاص بك. يؤدي التحقق الاختياري من DNS/meta/الملف إلى زيادة ضمان الأعمال ولكنه ليس مطلوبًا لكي يعمل التضمين على مجال مسجل.