SMS Online
الخدمات
  • احتفظ بالرقم نفسه للمدة التي تحتاجها واستقبل كل رسالة تصل إليه من أي تطبيق.

  • رقم Google Voice أمريكي جاهز مع حساب Google الخاص به.

  • معرّف Apple ID جاهز مع كل ما تحتاجه لتسجيل الدخول واسترداده.

  • بروكسيات خاصة حسب الدولة، للتسجيل والتطبيقات التي تحتاج عنوان IP محليًا.

  • رموز للألعاب والمتاجر وخدمات البث، تصل إلى حسابك بعد تأكيد الطلب.

لست متأكدًا؟ الرقم الافتراضي رمز واحد خلال 10 دقائق. أما الرقم المستأجر فهو لك، لرموز كثيرة.

انتقل إلىالبدء

مرجع API

اشترِ الأرقام الافتراضية والأرقام المستأجرة وأرقام Google Voice وبطاقات الهدايا من برنامجك الخاص. كل استدعاء هو طلب GET يحمل مفتاحك في الاستعلام، ويُدفع من المحفظة نفسها التي تستخدمها على الموقع.

عنوان URL الأساسيhttps://smsonline.io/api/v1

تفضّل النقر؟ تحتوي مجموعة Postman على كل الاستدعاءات جاهزة للإرسال.

الردود والأخطاء

تعيد الاستدعاءات الناجحة "status": 1 مع النتيجة في data. أي رد آخر يعني أن الاستدعاء لم ينفّذ شيئًا: اقرأ msg لمعرفة السبب.

1
نجاح
-1
فشل. لم يُخصم شيء ما لم تذكر msg خلاف ذلك
-2
لم تصل الرسالة بعد. واصل الاستعلام
رد الخطأ
{
  "status": -1,
  "error": "missing parameter",
  "msg": ["Insufficient inventory"]
}

الحساب

تحقق من المحفظة التي تُدفع منها كل عملية شراء.

GET/get-balance

يعيد رصيد المحفظة الحالي بالدولار الأمريكي.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
curl -G "https://smsonline.io/api/v1/get-balance" \
  -d apiKey=YOUR_API_KEY
مثال على الرد
{
  "status": 1,
  "data": { "balance": "24.60" }
}

الأرقام الافتراضية

أرقام لمرة واحدة للتحقق عبر الرسائل. ابحث عن منتج، واشترِه، ثم استعلم عن الرمز.

GET/virtual-number/get-countries

كل الدول التي يمكنك شراء رقم فيها. استخدم id الخاص بها كـ countryId.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
curl -G "https://smsonline.io/api/v1/virtual-number/get-countries" \
  -d apiKey=YOUR_API_KEY
مثال على الرد
{
  "status": 1,
  "data": [
    { "id": 1, "name": "United States", "image": "https://…/us.png" },
    { "id": 7, "name": "United Kingdom", "image": "https://…/gb.png" }
  ]
}

GET/virtual-number/get-services

كل التطبيقات التي يمكنك استقبال رمز لها. استخدم id الخاص بها كـ serviceId.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
curl -G "https://smsonline.io/api/v1/virtual-number/get-services" \
  -d apiKey=YOUR_API_KEY
مثال على الرد
{
  "status": 1,
  "data": [
    { "id": 2, "name": "Telegram", "image": "https://…/telegram.png" },
    { "id": 5, "name": "WhatsApp", "image": "https://…/whatsapp.png" }
  ]
}

GET/virtual-number/get-products

أسعار تطبيق واحد في دولة واحدة، صف لكل مشغّل (operatorId من 1 إلى 4) يعرض أرخص رقم لدى ذلك المشغّل. يتغير المشغّلون مع المخزون، لذا لا تشترِ إلا من operatorId أعاده هذا الاستدعاء للتو.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • countryIdمطلوبمعرّف الدولة من «قائمة الدول»
  • serviceIdمطلوبمعرّف الخدمة من «قائمة الخدمات»
curl -G "https://smsonline.io/api/v1/virtual-number/get-products" \
  -d apiKey=YOUR_API_KEY \
  -d countryId=1 \
  -d serviceId=2
مثال على الرد
{
  "status": 1,
  "data": [
    { "countryId": 1, "serviceId": 2, "operatorId": 1, "price": "0.45" },
    { "countryId": 1, "serviceId": 2, "operatorId": 3, "price": "0.72" },
    { "countryId": 1, "serviceId": 2, "operatorId": 4, "price": "0.64" }
  ]
}

شراء رقم

يخصم من محفظتك

GET/virtual-number/buy-service

يشتري رقمًا من المشغّل المختار بالسعر الذي أعادته «قائمة المنتجات»، ويخصم من محفظتك. يبقى الرقم نشطًا لمدة 10 دقائق.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • countryIdمطلوبمعرّف الدولة
  • serviceIdمطلوبمعرّف الخدمة
  • operatorIdمطلوبمعرّف المشغّل (من 1 إلى 4) من «قائمة المنتجات»
curl -G "https://smsonline.io/api/v1/virtual-number/buy-service" \
  -d apiKey=YOUR_API_KEY \
  -d countryId=1 \
  -d serviceId=2 \
  -d operatorId=1
مثال على الرد
{
  "status": 1,
  "data": {
    "order_id": 918273,
    "Number": "+14155550132",
    "country_name": "United States",
    "service_name": "Telegram",
    "country_image": "https://…/us.png",
    "service_image": "https://…/telegram.png"
  }
}

GET/virtual-number/get-sms

استعلم كل بضع ثوانٍ حتى يصل الرمز. status: -2 تعني ليس بعد. إذا لم تصل الرسالة في الوقت المحدد يفشل الطلب ويعود السعر إلى محفظتك.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • orderIdمطلوبorder_id من «شراء رقم»
curl -G "https://smsonline.io/api/v1/virtual-number/get-sms" \
  -d apiKey=YOUR_API_KEY \
  -d orderId=918273
مثال على الرد
{
  "status": 1,
  "code": "48213"
}

// still waiting
{ "status": -2, "error": "Sms not received", "msg": ["sms for this number is not received"] }

Google Voice

أرقام Google Voice أمريكية جاهزة مع حساب جوجل الخاص بها.

GET/google-voice/get-numbers

الأرقام المتوفرة الآن مع أسعارها.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
curl -G "https://smsonline.io/api/v1/google-voice/get-numbers" \
  -d apiKey=YOUR_API_KEY
مثال على الرد
{
  "status": 1,
  "data": [
    { "id": 3321, "number": "+1 (628) 555-0147", "price": "4.90", "type": 1, "country_name": "USA" }
  ]
}

GET/google-voice/get-number

رقم واحد من القائمة حسب معرّفه.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • idمطلوبمعرّف الرقم من «قائمة الأرقام»
curl -G "https://smsonline.io/api/v1/google-voice/get-number" \
  -d apiKey=YOUR_API_KEY \
  -d id=3321
مثال على الرد
{
  "status": 1,
  "data": { "id": 3321, "number": "+1 (628) 555-0147", "price": "4.90", "type": 1, "country_name": "USA" }
}

شراء رقم

يخصم من محفظتك

GET/google-voice/buy-number

يشتري الرقم وينشئ الطلب ويخصم من محفظتك.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • idمطلوبمعرّف الرقم من «قائمة الأرقام»
curl -G "https://smsonline.io/api/v1/google-voice/buy-number" \
  -d apiKey=YOUR_API_KEY \
  -d id=3321
مثال على الرد
{
  "status": 1,
  "data": { "order_id": 918274, "number": "+1 (628) 555-0147" }
}

استئجار رقم

احتفظ برقم لساعات أو أيام أو أسابيع أو أشهر واستقبل كل رسالة تُرسل إليه.

GET/rent-number/get-durations

مدد الاستئجار المتاحة والكميات المسموح بها لكل منها.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
curl -G "https://smsonline.io/api/v1/rent-number/get-durations" \
  -d apiKey=YOUR_API_KEY
مثال على الرد
{
  "status": 1,
  "data": [
    { "type": "hour", "time": [1, 2, 4, 8, 12] },
    { "type": "day", "time": [1, 2, 3, 4, 5, 6, 7] }
  ]
}

GET/rent-number/get-countries

الدول التي يمكنك الاستئجار فيها، مسعّرة للمدة التي تطلبها.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • typeمطلوبhour أو day أو week أو month
  • timeمطلوبعدد وحدات تلك المدة
curl -G "https://smsonline.io/api/v1/rent-number/get-countries" \
  -d apiKey=YOUR_API_KEY \
  -d type=day \
  -d time=3
مثال على الرد
{
  "status": 1,
  "type": "day",
  "time": "3",
  "data": [ { "id": 1, "name": "United States", "price": "2.85" } ]
}

استئجار رقم

يخصم من محفظتك

GET/rent-number/buy-number

ينشئ استئجارًا معلّقًا ويخصم من محفظتك. يُربط الرقم عند اكتمال الطلب.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • countryIdمطلوبمعرّف الدولة من «قائمة الدول»
  • typeمطلوبhour أو day أو week أو month
  • timeمطلوبعدد وحدات تلك المدة
curl -G "https://smsonline.io/api/v1/rent-number/buy-number" \
  -d apiKey=YOUR_API_KEY \
  -d countryId=1 \
  -d type=day \
  -d time=3
مثال على الرد
{
  "status": 1,
  "data": { "order_id": 918275, "status": "pending", "type": "day", "time": "3" }
}

بطاقات الهدايا

رموز للألعاب والمتاجر والبث. يؤكد فريقنا الطلبات، ثم يظهر الرمز.

GET/giftcard/get-list

كل بطاقات الهدايا المعروضة للبيع.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
curl -G "https://smsonline.io/api/v1/giftcard/get-list" \
  -d apiKey=YOUR_API_KEY
مثال على الرد
{
  "status": 1,
  "data": [
    { "id": 12, "brand": "Steam", "name": "Steam $20 US", "face_value": "20.00",
      "selling_price": "21.40", "currency_code": "USD", "category_name": "Games" }
  ]
}

GET/giftcard/get-detail

التفاصيل الكاملة لبطاقة هدايا واحدة.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • idمطلوبمعرّف البطاقة من «قائمة بطاقات الهدايا»
curl -G "https://smsonline.io/api/v1/giftcard/get-detail" \
  -d apiKey=YOUR_API_KEY \
  -d id=12
مثال على الرد
{
  "status": 1,
  "data": { "id": 12, "brand": "Steam", "name": "Steam $20 US", "selling_price": "21.40" }
}

شراء بطاقة هدايا

يخصم من محفظتك

GET/giftcard/buy

ينشئ طلبًا معلّقًا ويخصم من محفظتك. يُضاف الرمز بمجرد تأكيد الطلب.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • idمطلوبمعرّف بطاقة الهدايا
curl -G "https://smsonline.io/api/v1/giftcard/buy" \
  -d apiKey=YOUR_API_KEY \
  -d id=12
مثال على الرد
{
  "status": 1,
  "data": { "order_id": 918276, "order_status": "pending" }
}

GET/giftcard/order-status

استعلم عن طلب. عندما تكون قيمة order_status هي complete، يُضمَّن الرمز والرقم التسلسلي.

معاملات الاستعلام

  • apiKeyمطلوبمفتاح API الخاص بك
  • orderIdمطلوبorder_id من «شراء بطاقة هدايا»
curl -G "https://smsonline.io/api/v1/giftcard/order-status" \
  -d apiKey=YOUR_API_KEY \
  -d orderId=918276
مثال على الرد
{
  "status": 1,
  "data": { "order_id": 918276, "order_status": "complete", "code": "XXXX-XXXX-XXXX", "serial": "8812…" }
}

تسجيل الدخول أو إنشاء حساب

أدخل بريدك الإلكتروني. سنسجّل دخولك، أو ننشئ حسابك إن كنت جديدًا.