Documentation Index
Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt
Use this file to discover all available pages before exploring further.
نظرة عامة
بعد التحقق من صحة جميع المدخلات، أنت جاهز لإرسال طلب الشحن إلى API الخاص بـ OneClickDz. يغطي هذا الدليل تقديم الطلبات، ومعالجة الردود، وإدارة نظام المراجع الخاص بك.مرجع API
اطلع على توثيق API الكامل لـ endpoint POST /v3/mobile/send
طلب الشحن الأساسي
مثال بسيط
استجابة النجاح
توليد مراجع فريدة
احرص دائماً على توفير مراجع فريدة لمنع التكرار وتمكين التتبع:التحقق من الرصيد قبل الإرسال
تحقق دائماً من كفاية الرصيد لتجنب الطلبات الفاشلة:مرجع API الرصيد
تعرّف على endpoint GET /v3/account/balance
معالجة الأخطاء
تعامل مع أخطاء API الشائعة:راجع مرجع معالجة الأخطاء للاطلاع على رموز الأخطاء الكاملة واستراتيجيات المعالجة.
التكامل مع قاعدة البيانات
سجّل الطلبات قبل وبعد استدعاءات API:المعالجة غير المتزامنة
للحصول على أداء أفضل، عالج الشحنات بشكل غير متزامن:منطق إعادة المحاولة
طبّق إعادة المحاولة لأخطاء الشبكة:أفضل الممارسات
استخدام مراجع فريدة دائماً
استخدام مراجع فريدة دائماً
أنشئ
ref فريداً لكل طلب لمنع التكرار وتمكين التتبع.التحقق من الرصيد مسبقاً
التحقق من الرصيد مسبقاً
تحقق من كفاية الرصيد قبل الإرسال لتجنب الطلبات الفاشلة.
استخدام معاملات قاعدة البيانات
استخدام معاملات قاعدة البيانات
غلّف إنشاء الطلب وخصم الرصيد في معاملات لضمان اتساق البيانات.
المعالجة غير المتزامنة
المعالجة غير المتزامنة
استخدم قوائم الانتظار للحصول على أداء أفضل وتجربة مستخدم محسّنة.
تطبيق منطق إعادة المحاولة
تطبيق منطق إعادة المحاولة
أعد المحاولة عند أخطاء الشبكة مع التراجع الأسي، لكن لا تُعد المحاولة عند أخطاء التحقق من الصحة.
تسجيل كل شيء
تسجيل كل شيء
سجّل جميع الطلبات والردود لأغراض التنقيح والتدقيق.
الخطوات التالية
الخطوة 4: استطلاع الحالة
تعلّم كيفية استطلاع وتتبع حالة الشحن
API التحقق بالمرجع
توثيق API لـ GET /v3/mobile/check-ref/:ref
API التحقق بالمعرّف
توثيق API لـ GET /v3/mobile/check-id/:id
مرجع معالجة الأخطاء
دليل معالجة الأخطاء والتعافي منها
إعداد Webhooks
إعداد إشعارات الحالة في الوقت الفعلي
استراتيجيات الاستطلاع
تحسين تطبيق الاستطلاع الخاص بك
API سجل المعاملات
اطلع على سجل معاملاتك
API الرصيد
endpoint التحقق من رصيد الحساب

