API Grizzly SMS

&action=getNumber
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك
$service — رمز الخدمة
$country — رمز البلد
$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 — رمز البلد
$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 – تاريخ بدء التفعيل.

&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 من منطقة أخرى

&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
    }
  }
}

&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 – مفتاح واجهة برمجة التطبيقات الخاص بك (موجود في الإعدادات)
$coin – العملة الرقمية (usdt);
$network – الشبكة (trс-20)

مثال على الرد:

  {
        "wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
    }