Skip to main content
GET
التحقق من الحالة بالمرجع

نظرة عامة

يُرجع حالة شحن هاتف محمول باستخدام قيمة ref التي حددتها عند إرسال الشحن.
إذا أرسلت طلبًا بدون ref، استخدم check-by-id مع topupId المُرجع.

المعلمات

string
مطلوب
مرجعك الداخلي كما وفّرته في طلب الشحن

الاستجابة

boolean
مطلوب
true إذا تم العثور على الشحن وإرجاع حالته
object
مطلوب

قيم الحالة

الأمثلة

مثال على الاستجابة

استراتيجية الاستطلاع (Polling)

متى تستخدم هذا الـ Endpoint

استعلامات المستخدمين

عندما يسأل المستخدمون عن طلباتهم باستخدام معرّف الطلب الخاص بك

إدارة الطلبات

التكامل مع نظام تتبع الطلبات الحالي لديك

صفحات الحالة

عرض حالة الطلب باستخدام مراجع مواجهة العملاء

دعم العملاء

البحث عن الطلبات عبر أرقام المراجع الخاصة بالعملاء

استجابة الخطأ

404 - غير موجود:
هذا يعني أنه لا يوجد شحن بهذا المرجع. الأسباب المحتملة:
  • لم يُرسَل المرجع أبداً
  • خطأ إملائي في المرجع
  • المرجع ينتمي إلى حساب مختلف

أفضل الممارسات

أنشئ مراجع تكون:
  • فريدة في نظامك
  • سهلة التعرف عليها (مثل order-{timestamp}-{userId})
  • آمنة في عناوين URL (بدون أحرف خاصة)
  • قابلة للبحث في قاعدة بياناتك
احفظ كلاً من مرجعك ومعرّف topupId الخاص بـ API:
يتيح لك ذلك التتبع باستخدام أي من المعرّفين.
إذا نسيت تقديم ref، ينشئ الـ API مرجعاً تلقائياً. احفظه:

Endpoints ذات الصلة

التحقق من الحالة بالمعرّف

البحث بـ topupId

إرسال الشحن

إرسال شحن جديد

قائمة الشحنات

عرض الشحنات السابقة