المطوّرون
إرسال مهمة عبر واجهة API للعملاء
المفاتيح، وعدم التكرار (idempotency)، والحدود، وتقسيم النتائج إلى صفحات.
استخدم مفتاحًا محدد النطاق
استخدم مفتاحًا مباشرًا (Live) بنطاق الإرسال (submit) للتحقق في بيئة الإنتاج. احتفظ به على خادمك، وامنحه فقط نطاقات الإرسال (submit) أو القراءة (read) أو الرصيد (balance) التي تحتاجها. تحاكي مفاتيح الاختبار (Test) عناوين أمثلة محجوزة دون أي استدعاء لمزوّد الخدمة أو استهلاك للأرصدة.
يحتسب حدّ إنفاق المفتاح المباشر الرصيد المخصوم مضافًا إليه الحجوزات المقبولة. وإذا بُلغ الحد، تُرفض المهمة الجديدة دون إنشاء حجز. ويُحجز رصيد مساحة العمل عند قبول عمليات التحقق للمعالجة، وفق قواعد الخصم والإعادة نفسها المتبعة في لوحة التحكم.
إعادة المحاولة بأمان
أرسل مفتاح Idempotency-Key ثابتًا مع كل مهمة. تُعيد إعادة المحاولة المطابقة المهمة نفسها. استخدم معرّف المهمة المُعاد لقراءة الحالة والنتائج المقسّمة إلى صفحات. يُرفض المفتاح المكرر إذا اختلفت البيانات المرسلة.
قد يؤدي إيقاف تشغيلي مؤقت إلى رفض مهام التحقق المباشر الجديدة مع الاستجابة HTTP 503 live_verification_unavailable ودون حجز أي رصيد. أعد المحاولة لاحقًا باستخدام مفتاح عدم التكرار نفسه. وهذا منفصل عن أذونات مفاتيح API وحدودها القصوى وحدود المعدّل.