الانتقال إلى المحتوى الرئيسي
POST
/
v3
/
internet
/
send
إرسال شحن الإنترنت
curl --request POST \
  --url https://api.oneclickdz.com/v3/internet/send \
  --header 'X-Access-Token: <api-key>'

​
نظرة عامة

اشترِ بطاقات شحن الإنترنت لخدمات ADSL أو 4G LTE مع التسليم الرقمي الفوري.
تحقق دائماً من أرقام الهاتف قبل الإرسال لتقليل الأخطاء.

​
جسم الطلب

​
type
string
مطلوب
نوع الخدمة: ADSL أو 4G
​
number
string
مطلوب
رقم الهاتف - ADSL: 0[0-9]{8} (مثال: 036362608) - 4G: 213[0-9]{9} (مثال: 213472731602)
​
value
number
مطلوب
القيمة الاسمية للبطاقة من /internet/products (مثال: 500، 1000، 2000)
​
ref
string
مرجع طلبك الفريد (اختياري، يُنشأ تلقائياً إن لم يُقدَّم)

​
أمثلة

curl https://api.oneclickdz.com/v3/internet/send \
  -X POST \
  -H "Content-Type: application/json" \
  -H "X-Access-Token: YOUR_API_KEY" \
  -d '{
    "type": "ADSL",
    "number": "036362608",
    "value": 1000,
    "ref": "internet-order-001"
  }'

​
استجابة النجاح

{
  "success": true,
  "data": {
    "topupId": "690161a3e9e88196b4eb6545",
    "topupRef": "API-+213665983439-test-internet-1761698210633"
  },
  "meta": {
    "timestamp": "2025-10-29T00:36:52.065Z"
  }
}

​
دورة حياة الحالة

1

HANDLING

قيد المعالجة لدى المشغل (3 إلى 45 ثانية عادةً)
2

الحالات النهائية

  • FULFILLED: تم تسليم البطاقة ✅ - REFUNDED: فشل واسترداد ❌ - QUEUED: مجدول لاحقاً (12 إلى 48 ساعة) ⏰
تتبع الحالة →

​
ردود الخطأ

معاملات طلب غير صالحة
تنسيق رقم هاتف غير صالح أو عدم تطابق النوع
قيمة البطاقة غير متوفرة
رصيد غير كافٍ
المرجع مستخدم مسبقاً

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

التحقق أولاً

استخدم /check-number قبل الإرسال

التحقق من المخزون

تأكد من توافر المنتج

مراجع فريدة

قدِّم ref فريداً للتتبع

استعلام الحالة

تحقق من الحالة بعد الإرسال

​
روابط ذات صلة

التحقق من الرقم

التحقق من صحة الرقم

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

تتبع الطلب

قائمة المنتجات

البطاقات المتاحة