
API — this is the protocol of interaction between your software and our activation server. The API is needed to automate the process of receiving SMS messages on your side
Our API is compatible with the sms-activate API
All requests must have an API key in the form of the api_key parameter

&action=getNumber
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك
$service — رمز الخدمة
$country — رمز البلد. يمكنك تمرير "any" أو ترك القيمة فارغة ليختار النظام تلقائيًا أفضل بلد متاح بناءً على المخزون والسعر وقابلية التسليم.
$maxPrice — السعر الأقصى الذي ترغب في شرائه للحصول على رقم
$providerIds — قائمة بالموردين الذين سيتم الشراء منهم، مفصولة بفواصل (1,2,3)
$exceptProviderIds — قائمة بالموردين المستبعدين من شراء الرقم، مفصولة بفواصل (1,2,3)
الأخطاء المحتملة:
BAD_KEY — تحقق من مفتاح واجهة برمجة التطبيقات (API key) الخاص بك;
NO_NUMBERS — كرر الطلب أو اختر بلدًا آخر.
The service is prohibited for sale by administration — يُرجى اختيار خدمة أخرى
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى
مثال للإجابة الناجحة:
ACCESS_NUMBER:38496653:66846426435
حيث يمثل 38496653 معرّف التنشيط، و66846426435 هو رقم الهاتف.
&action=getNumberV2
تعمل هذه الطريقة بشكل مشابه لطريقة getNumber، وتتلقى نفس المعلمات، لكنها تُرجع معلومات إضافية عن التفعيل.
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك
$service — رمز الخدمة
$country — رمز البلد. يمكنك تمرير "any" أو ترك القيمة فارغة ليختار النظام تلقائيًا أفضل بلد متاح بناءً على المخزون والسعر وقابلية التسليم.
$maxPrice — السعر الأقصى الذي ترغب في شرائه للحصول على رقم
$providerIds — قائمة بالموردين الذين سيتم الشراء منهم، مفصولة بفواصل (1,2,3)
$exceptProviderIds — قائمة بالموردين المستبعدين من شراء الرقم، مفصولة بفواصل (1,2,3)
الأخطاء المحتملة:
BAD_KEY — تحقق من مفتاح واجهة برمجة التطبيقات (API key) الخاص بك;
NO_NUMBERS — كرر الطلب أو اختر بلدًا آخر.
The service is prohibited for sale by administration — يُرجى اختيار خدمة أخرى
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى
مثال للإجابة الناجحة:
{
"activationId": 38496653,
"phoneNumber": "66846426435",
"activationCost": 12.34,
"currency": 840,
"countryCode": "2",
"canGetAnotherSms": "1",
"activationTime": "2025-12-31 23:30:55"
}
حيث إن 38496653 هو معرّف التفعيل.
66846426435 هو رقم الهاتف،
12.34 – سعر الشراء،
870 – رمز العملة وفقًا لمعيار ISO 4217،
2 – رمز الدولة،
0/1 = يشير إلى دعم الرسالة النصية الثانية (خطأ/صحيح)،
2025-12-31 23:30:55 – تاريخ بدء التفعيل.
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setStatus&status=$status&id=$id
&action=setStatus
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
$id — معرف التنشيط;
$status — حالة التنشيط:
-1 — إلغاء التنشيط
1 — إبلاغ عن استعداد الرقم (تم إرسال رسالة نصية قصيرة إلى الرقم);
3 — انتظر رمزًا آخر لنفس الرقم;
6 — اكتمال التنشيط;
8 — إلغاء التنشيط.
استجابات الخدمة:
ACCESS_READY — تمت تأكيد توفر الرقم
ACCESS_RETRY_GET — انتظار رسالة نصية قصيرة جديدة
ACCESS_ACTIVATION — تم تنشيط الخدمة بنجاح
ACCESS_CANCEL — تم إلغاء التنشيط
الأخطاء المحتملة:
ERROR_SQL — خطأ في خادم SQL
NO_ACTIVATION — معرف التنشيط غير موجود
BAD_SERVICE — اسم الخدمة غير صحيح
BAD_STATUS — حالة غير صحيحة
BAD_KEY — مفتاح واجهة برمجة التطبيقات غير صالح
BAD_ACTION — إجراء غير صحيح
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getStatus&id=$id
&action=getStatus
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
$id — معرف التنشيط.
استجابات الخدمة:
STATUS_WAIT_CODE — ينتظر وصول رسالة نصية قصيرة
STATUS_WAIT_RETRY:$lastcode — في انتظار تحسين الرمز (حيث يكون $lastcode هو آخر رمز غير مناسب)
STATUS_WAIT_RESEND — في انتظار إعادة إرسال الرسالة النصية القصيرة (يجب على البرنامج النقر على إعادة إرسال الرسالة النصية القصيرة وإجراء تغيير في الحالة إلى 6)
STATUS_CANCEL — تم إلغاء التنشيط
STATUS_OK:$code — تم استلام الرمز (حيث يكون $code هو رمز التنشيط).
الأخطاء المحتملة:
NO_ACTIVATION — معرف التنشيط غير موجود
BAD_KEY — مفتاح واجهة برمجة التطبيقات غير صالح
BAD_ACTION — إجراء غير صحيح
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى
&action=getBalance
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
استجابة الخدمة:
ACCESS_BALANCE:$balance (حيث يكون $balance هو رصيد الحساب)
الأخطاء المحتملة:
BAD_KEY — مفتاح واجهة برمجة التطبيقات غير صالح
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى
&action=getPrices
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
$service — رمز الخدمة;
$country — رمز البلد.
استجابات الخدمة بالتنسيق التالي
على سبيل المثال، طلب بهذا الشكل https://api.grizzlysms.com/stubs/handler_api.php?api_key=YOURKEY&action=getPrices&country=0
{
"Country": {
"Service": {
"cost": Cost,
"count": Quantity
}
}
}
الأخطاء المحتملة:
BAD_KEY — مفتاح واجهة برمجة التطبيقات غير صالح
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى
&action=getPricesV2
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
$service — رمز الخدمة
$country — رمز البلد
الأخطاء المحتملة:
BAD_KEY — تحقق من مفتاح واجهة برمجة التطبيقات (API key) الخاص بك
BAD_ACTION — إجراء غير صحيح
BAD_SERVICE — اسم الخدمة غير صحيح
استجابات الخدمة بالتنسيق التالي
"country": {
"service": {
"price1": count,
"price2": count,
"price3": count,
}
},
&action=getPricesV3
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
$service — رمز الخدمة
$country — رمز البلد
الأخطاء المحتملة:
BAD_KEY — تحقق من مفتاح واجهة برمجة التطبيقات (API key) الخاص بك
BAD_ACTION — إجراء غير صحيح
BAD_SERVICE — اسم الخدمة غير صحيح
استجابات الخدمة بالتنسيق التالي
{
"country": {
"service": {
"price": price,
"count": count,
"providers": {
"provider 1 id": {
"count": count,
"price": [price1, price2],
"provider_id": provider_id
},
"provider 2 id": {
"count": count,
"price": [price],
"provider_id": provider_id
},
"provider 3 id": {
"count": count,
"price": [price1, price2, price3],
"provider_id": provider_id
}
}
}
}
}
$api_key – مفتاح واجهة برمجة التطبيقات الخاص بك (موجود في الإعدادات)
مثال على الرد:
{
"services": [
{
"code": "kt",
"name": "KakaoTalk"
}
]
}
$api_key – مفتاح واجهة برمجة التطبيقات الخاص بك (موجود في الإعدادات)
مثال على الرد:
{
{
"id": 22
"rus": "India"
"eng": "India"
"chn": "India"
}
}
$api_key – مفتاح واجهة برمجة التطبيقات الخاص بك (موجود في الإعدادات)
$coin – العملة (مثال: usdt)
$network – شبكة البلوك تشين (مثال: trc20)
مثال على الرد:
{
"wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
}