واجهة المطوّرين البرمجية
التحقق عبر SMS مباشرة من شيفرتك
استدعاء HTTPS واحد يمنح البوت أو المنصة رقمًا حقيقيًا لواتساب وتيليجرام وخدمات أخرى كثيرة. استلم الرمز عبر ويب هوك أو الاستطلاع الطويل، وادفع فقط مقابل الأرقام التي وصلها الرمز.
- ١٬٣٢١خدمة
- ١٤٥دولة
- ٠٫١٠ US$أدنى سعر للرقم
- تلقائياسترداد إن لم يصل الرمز
curl
curl -s -X POST https://smsgrab.com/api/dev/v1/activations \
-H "Authorization: Bearer $SMSGRAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"whatsapp","country":"indonesia"}'Python
activation = requests.post(
"https://smsgrab.com/api/dev/v1/activations",
headers={"Authorization": f"Bearer {key}"},
json={"service": "whatsapp", "country": "indonesia"},
).json()Node.js
const activation = await fetch('https://smsgrab.com/api/dev/v1/activations', {
method: 'POST',
headers: { Authorization: `Bearer ${key}`, 'Content-Type': 'application/json' },
body: JSON.stringify({ service: 'whatsapp', country: 'indonesia' }),
}).then((response) => response.json());PHP
$activation = json_decode((string) $client->post('activations', [
'json' => ['service' => 'whatsapp', 'country' => 'indonesia'],
])->getBody(), true);Go
order := map[string]any{"service": "whatsapp", "country": "indonesia"}
err := call("POST", "/activations", order, idempotencyKey(), &activation){
"id": "5c1d0c2e-9f3a-4b7e-8a61-2f0c9d4e7b10",
"compat_id": 100000123,
"status": "WAITING_SMS",
"service_id": "whatsapp",
"country_id": "indonesia",
"phone_number": "+6281234567890",
"price_minor": 18,
"currency": "USD",
"expires_at": "2026-09-27T10:25:00.000Z",
"sms": []
}مصممة للأتمتة
كل ما يحتاجه تكاملك، بالمخزون والمحاسبة والاستردادات نفسها التي في التطبيق.
-
واجهة REST واضحة
JSON متوقع، ومشتريات متكررة بأمان، وأسباب أخطاء واضحة يمكنك التعامل معها.
-
ويب هوك موقّعة
أحداث موقّعة بـ HMAC لكل رمز وتغيير حالة، مع إعادة المحاولة لمدة 24 ساعة.
-
الاستطلاع الطويل
أبقِ الطلب مفتوحًا حتى 30 ثانية واستلم الرمز لحظة وصوله.
-
متوافق مع sms-activate
وجّه أدواتك الحالية إلى عنواننا. تبقى الإجراءات والاستجابات كما هي.
-
مفاتيح تتحكم بها
مفاتيح للقراءة فقط أو للشراء، وقوائم IP مسموحة، وحدود يومية، وصلاحية، وتبديل دون توقف.
-
استردادات تلقائية
لم يصل الرمز قبل انتهاء الرقم؟ يعود المبلغ إلى رصيدك فورًا.
-
الاستخدام وسجل الطلبات
الطلبات والإنفاق والأخطاء يوميًا لكل مفتاح، مع سجل قابل للتصفية لآخر 7 أيام.
-
أسعار حسب الحجم
أسعار مبنية على سعر الجملة تنخفض تلقائيًا مع نمو حجمك الشهري.
ابدأ في أربع خطوات
بضعة استدعاءات فقط تفصلك عن أول رقم.
-
أنشئ حسابًا
سجّل ببريدك الإلكتروني وأكّده. التطبيق والموقع يستخدمان الحساب نفسه.
-
أنشئ مفتاح API
اختر الوصول وقيّد المفتاح بخوادمك وانسخ السر مرة واحدة.
-
اشترِ رقمًا
أرسل الخدمة والدولة بطلب POST. يصلك الرقم والسعر فورًا.
-
استلم الرمز
انتظره عبر الاستطلاع الطويل أو الويب هوك، ثم أنهِ التفعيل.
أسعار تنخفض كلما نموت
أسعار المطوّرين تبدأ من تكلفة الجملة لكل رقم مضافًا إليها زيادة تتناقص مع حجمك خلال 30 يومًا.
- لا تتجاوز أبدًا سعر الرقم نفسه في التطبيق
- بحد أدنى ٠٫١٠ US$ للرقم
- الأرقام التي لا يصلها رمز تُسترد تلقائيًا
- يتحدث مستواك خلال دقائق من بلوغه
- يُخصم بالدولار من رصيد التطبيق نفسه
الزيادة حسب إنفاق المطوّر خلال 30 يومًا
| إنفاق المطوّر خلال 30 يومًا | الزيادة على سعر الجملة | سعر توضيحي |
|---|---|---|
| حتى ١٠٠٫٠٠ US$ | +٨٠% | ٠٫١٨ US$ أقل بنسبة ٢٨% من التطبيق |
| من ١٠٠٫٠٠ US$ | +٧٠% | ٠٫١٧ US$ أقل بنسبة ٣٢% من التطبيق |
| من ٥٠٠٫٠٠ US$ | +٦٠% | ٠٫١٦ US$ أقل بنسبة ٣٦% من التطبيق |
| من ٢٬٠٠٠٫٠٠ US$ | +٥٠% | ٠٫١٥ US$ أقل بنسبة ٤٠% من التطبيق |
مثال: عرض بسعر جملة ٠٫١٠ US$ يُباع في التطبيق بـ ٠٫٢٥ US$.
الانتقال
انتقل من sms-activate بتغيير سطر واحد
عنواننا المتوافق يتحدث البروتوكول نفسه، فتعمل البوتات ولوحات التحكم المصممة لـ sms-activate بمجرد تغيير العنوان الأساسي والمفتاح.
https://smsgrab.com/api/stubs/handler_api.php
- getNumber وgetStatus وsetStatus وgetPrices وبقية الإجراءات القياسية
- معرّفات التفعيل الرقمية ورموز الخدمات ومعرّفات الدول التي تستخدمها بالفعل
- المفاتيح والحدود والأسعار والاستردادات والويب هوك نفسها كما في واجهة REST
curl
BASE="https://smsgrab.com/api/stubs/handler_api.php?api_key=$SMSGRAB_API_KEY"
curl -s "$BASE&action=getBalance"
curl -s "$BASE&action=getNumber&service=tg&country=6"
curl -s "$BASE&action=getStatus&id=100000123"
curl -s "$BASE&action=setStatus&id=100000123&status=6"Python
import os
import requests
BASE = "https://smsgrab.com/api/stubs/handler_api.php"
KEY = os.environ["SMSGRAB_API_KEY"]
def action(name: str, **params) -> str:
response = requests.get(BASE, params={"api_key": KEY, "action": name, **params}, timeout=30)
response.raise_for_status()
return response.text
print(action("getBalance"))
answer = action("getNumber", service="tg", country=6)
if answer.startswith("ACCESS_NUMBER:"):
_, activation_id, number = answer.split(":")
print(activation_id, number)في الوقت الفعلي
الرموز تصل مباشرة إلى خادمك
اشترك في الأحداث التي تهمك، وسنسلّمها إلى عنوان HTTPS الخاص بك مع توقيع يمكنك التحقق منه.
- تم شراء رقم
- تم استلام الرمز
- اكتمل التفعيل
- أُلغي التفعيل
- انتهى التفعيل
- تم الاسترداد
- الرصيد منخفض
- كل تسليم موقّع بـ HMAC-SHA256 مع طابع زمني
- عناوين HTTPS العامة فقط، مع فحصها قبل كل تسليم
- تسليمات اختبارية وسجل لمدة 30 يومًا وإعادة تسليم بنقرة واحدة
أسئلة المطوّرين
كم تكلف واجهة المطوّرين؟
لا يوجد اشتراك. كل رقم يكلف سعر الجملة مضافًا إليه زيادة 80%، تنخفض إلى 70% و60% و50% عندما يتجاوز إنفاقك خلال 30 يومًا 100 و500 و2000 دولار. لا يقل سعر الرقم أبدًا عن 0.10 دولار ولا يتجاوز سعره في التطبيق.
ماذا يحدث إن لم يصل الرمز؟
يبقى الرقم نشطًا 20 دقيقة. إن لم يصل رمز خلالها، أو ألغيت الرقم وهو لا يزال في الانتظار، يعود المبلغ إلى رصيدك تلقائيًا.
هل يمكنني استخدام تكاملي مع sms-activate؟
نعم. غيّر العنوان الأساسي إلى عنواننا المتوافق واستخدم مفتاح SmsGrab. تبقى الإجراءات القياسية والاستجابات والمعرّفات الرقمية كما هي.
ما حدود المعدل؟
افتراضيًا يمكن لكل مفتاح إجراء 600 طلب و60 عملية شراء في الدقيقة، ولكل مفاتيح الحساب معًا 3000 طلب في الدقيقة، ويمكن أن ينتظر حتى 100 رقم رمزًا في الوقت نفسه.
كيف أحمي مفتاحي؟
احفظ المفاتيح على الخوادم فقط، وامنح كل تطبيق مفتاحه، وقيّده بعناوين خوادمك، وحدّد سقف إنفاق يوميًا. إن احتمل تسرّب مفتاح، بدّله أو ألغِه من حسابك.
هل يتشارك التطبيق والواجهة الرصيد نفسه؟
نعم. تستخدم الواجهة رصيد حسابك في SmsGrab، وتظهر كل عملية شراء واسترداد في محفظتك مثل أي عملية أخرى.
مزيد من الإجابات في مركز المساعدة