انتقل إلىالبدء
مرجع API
اشترِ الأرقام الافتراضية والأرقام المستأجرة وأرقام Google Voice وبطاقات الهدايا من برنامجك الخاص. كل استدعاء هو طلب GET يحمل مفتاحك في الاستعلام، ويُدفع من المحفظة نفسها التي تستخدمها على الموقع.
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 أو monthtimeمطلوبعدد وحدات تلك المدة
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 أو monthtimeمطلوبعدد وحدات تلك المدة
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…" }
}