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 من الحقل المخفي (قد تستمر عمليات التضمين القديمة في إرسال رمز الاستقصاء). راجع دليل التحقق من الخادم. للاطلاع على أحداث المتصفح وعناوين URL المُعادة، راجع تضمين مرجع APIللأحداث ومعالجة عنوان URL للإرجاع.

أنواع الطلب

نوع الطلب	مطالبة الخادم (المطالبات المطلوبة)	الاستخدام النموذجي
`human`	`تم التحقق منه بواسطة الإنسان`	تقليل الروبوتات/البريد العشوائي
`age_over_13`	`العمر فوق 13 سنة`	محتوى مخصص لمن هم فوق 13 عامًا أو بوابات على غرار قانون حماية خصوصية الأطفال على الإنترنت (COPPA).
`age_over_16`	`العمر فوق 16 عامًا`	محتوى لمن هم فوق 16 عامًا أو قواعد السن الإقليمية
`age_over_18`	`العمر فوق 18 عامًا`	18+ محتوى أو الخروج
`age_over_21`	`العمر فوق 21 عامًا`	21+ منتج (كحول أمريكي، إلخ.)
`age_over_25`	`العمر فوق 25 عامًا`	عتبات عمرية أعلى

استخدم أنواع الطلبات هذه في ملف التضمين (data-checkify-request أو Checkify.bindForm). على خادمك، تحقق من صحة البيانات باستخدام المطالبة المطابقة في required_claims.

ربط النطاق