منتجات الوقت الفعلي

تعنون نقاط نهاية الوقت الفعلي المنتجات بـالمعرّف الرقمي. أما نقاط النهاية الجماعية فتعنونها بـالمعرّف النصي. وهما غير قابلين للتبادل: فالمعرّف الرقمي المُمرَّر إلى طلب جماعي والمعرّف النصي المُمرَّر إلى طلب وقت فعلي كلاهما مرفوض.

يُولَّد هذا الجدول من الكتالوج الحيّ عند كل عملية بناء للموقع، لذا يطابق دائمًا ما يُرجعه GET /v1/products.

مرّر هذه المعرّفات الرقمية في product_ids. يقبل الفوري المعرّفات فقط — ولا تعمل هنا المُعرّفات النصية الواردة في جدول الدفعات. ويمكن للطلب الواحد اختيار منتجات من سلسلة واحدة في المرة.

اسم المنتج	الوضع	المُعرّف	الحد الأدنى
التحقق من رقم Amazon	فردي (فوري)	#53	1
التحقق من بريد Amazon الإلكتروني	فردي (فوري)	#54	1
التحقق من رقم Apple ID	فردي (فوري)	#57	1
التحقق من بريد Apple ID الإلكتروني	فردي (فوري)	#58	1
التحقق من رقم BAND	فردي (فوري)	#60	1
التحقق من رقم Facebook	فردي (فوري)	#51	1
التحقق من بريد Facebook الإلكتروني	فردي (فوري)	#52	1
التحقق من رقم Instagram	فردي (فوري)	#48	1
التحقق من بريد Instagram الإلكتروني	فردي (فوري)	#49	1
التحقق من رقم Microsoft	فردي (فوري)	#59	1
التحقق من رقم Telegram	فردي (فوري)	#50	1
التحقق من رقم Viber	فردي (فوري)	#55	1
التحقق من رقم WhatsApp	فردي (فوري)	#47	1
التحقق من رقم الهاتف على X	فردي (فوري)	#61	1

يُحدَّث هذا الجدول تلقائيًا من الكتالوج المباشر عند كل بناء للموقع.

قراءة المعرّف من هذا الجدول

يحتوي عمود # على القيمة التي تمرّرها. وبالنسبة لمنتج وقت فعلي، فهي id الخاص بالمنتج في GET /v1/products.

{ "product_ids": [49] }

المعرّفات المعروضة أعلاه هي الحالية. وتُضاف المنتجات وتُسحب بمرور الوقت، لذا اعتبر هذه الصفحة — لا مثالًا منسوخًا من مكان آخر — مصدر الحقيقة.

سلسلتان، بلا خلط

ينتمي كل منتج وقت فعلي إلى سلسلة واحدة، phone أو email، ولا يجوز للطلب الواحد أن يختار منتجات إلا من سلسلة واحدة:

• طلب الهاتف (/v1/realtime/check/phone) يأخذ معرّفات منتجات الهاتف
• طلب البريد الإلكتروني (/v1/realtime/check/email) يأخذ معرّفات منتجات البريد الإلكتروني

خلط السلسلتين في طلب واحد مرفوض باعتباره طلب وقت فعلي غير صالح. والقاعدة نابعة مما يُتحقق منه: فرقم الهاتف له بلد، وعنوان البريد الإلكتروني ليس له بلد، لذا لا يمكن أن يتشاركا مرور تحقق واحد.

اختيار أكثر من منتج واحد

يمكنك تمرير من واحد إلى عشرة معرّفات في طلب واحد. وينتج كل منتج مختار مدخله الخاص في results واحتسابه الخاص، كل ذلك تحت request_id واحد:

{ "product_ids": [49, 52, 54] }

أكثر من عشرة معرّفات مرفوض بـ invalid_realtime_request. ولتنفيذ أكثر من عشرة فحوص لمعرّف واحد، أرسل أكثر من طلب — لكل منها Idempotency-Key خاص به.

من أين يأتي السعر

يُحتسب كل منتج بسعره الخاص لكل فحص، بما في ذلك عندما تُقدَّم النتيجة من الذاكرة المؤقتة. ونقطة نهاية الكتالوج لا تُظهر أي تسعير عن قصد — فـ GET /v1/products تُرجع id وslug وname وname_translations وmode وseries وmin_phones، ولا شيء غير ذلك. الأسعار الحالية موجودة في صفحة الأسعار داخل حسابك.

راجع الفوترة والاسترداد لمعرفة النتائج التي تُحتسب بدقة.