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 – مفتاح API الخاص بك;
$service – رمز الخدمة;
$country – رمز الدولة;
$time – وقت الإيجار (بحد أدنى 4 ساعات).

ستكون استجابة الخدمة بتنسيق JSON:

{
  "status": "status",
  "phone": {
    "id": "id rent",
    "endDate": "rent expiration date",
    "number":"phone number"
  }
}

مثال للإجابة الناجحة:

{
  "status": "success",
  "phone": {
    "id": "38496653",
    "endDate": "2023-12-31T19:30:52",
    "number": "66846426435"
  }
}

مثال للإجابة التي تحتوي على خطأ:

{
  "status": "error",
  "error": "BAD_KEY"
}

الأخطاء المحتملة:
BAD_KEY – تحقق من مفتاح API الخاص بك;
BAD_COUNTRY – تحقق من رمز الدولة;
BAD_SERVICE – تحقق من رمز الخدمة;
INVALID_TIME – تحقق من عدد الساعات;
NO_BALANCE – رصيد الحساب غير كافٍ;
NO_NUMBERS – كرر الطلب أو اختر دولة أخرى;
SERVER_ERROR – خطأ في الخادم، أعد إرسال الطلب لاحقًا
The service is prohibited for sale by administration — يُرجى اختيار خدمة أخرى
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى

$api_key – مفتاح API الخاص بك (الإعدادات);
$time - وقت الإيجار (بحد أدنى 4 ساعات).

ستكون استجابة الخدمة بتنسيق JSON:

{
  "status": "status",
  "phone": {
    "id": "id rent",
    "endDate": "rent expiration date",
    "number": "phone number"
  }
}

مثال للإجابة الناجحة:

{
  "status": "success",
  "phone": {
    "id": "38496653",
    "endDate": "2023-12-31T19:30:52",
    "number": "66846426435"
  }
}

مثال للإجابة التي تحتوي على خطأ:

{
  "status": "error",
  "error":"BAD_KEY"
}

الأخطاء المحتملة:
BAD_KEY – تحقق من مفتاح API الخاص بك;
INVALID_TIME – تحقق من عدد الساعات;
NO_ID_RENT – تحقق من معرف الإيجار;
NO_BALANCE – رصيد الحساب غير كافٍ;
RENT_DIE – لم يعد هذا الرقم متاحًا، قم باختيار رقم جديد;
SERVER_ERROR – خطأ في الخادم، أعد إرسال الطلب لاحقًا.
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى

$api_key – مفتاح API الخاص بك (الإعدادات);
$id – معرف الإيجار;

ستكون استجابة الخدمة بتنسيق JSON:

{
  "status": "status",
  "quantity": "number of times rented",
  "values": {
    "1": {
      "date": "rent commencement date",
      "price": rentalCost,
      "hours":rentDuration
    }
  }

مثال للإجابة الناجحة:

{
  "status": "success",
  "quantity": "2",
  "values": {
    "1": {
      "date": "2023-10-26 11:03:39",
      "price": 3.6,
      "hours": 4
    },
    "2": {
      "date":"2023-10-25 11:02:31",
      "price": 4,
      "hours": 5
    }
  }
}

مثال لاستجابة ناجحة بدون رقم:

{
  "status": "success",
  "values": {}
}

مثال للإجابة التي تحتوي على خطأ:

{
  "status": "error",
  "error": "SQL_ERROR"
}

الأخطاء المحتملة:
BAD_KEY – تحقق من مفتاح API الخاص بك;
NO_ID_RENT – تحقق من معرف الإيجار;
SQL_ERROR – خطأ في خادم SQL، أعد إرسال الطلب لاحقًا.
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى

$api_key – مفتاح API الخاص بك (الإعدادات);
$id – معرف الإيجار;
$status – حالة الإيجار:
1 – إنهاء الإيجار;
2 – إلغاء الإيجار.

ستكون استجابة الخدمة بتنسيق JSON:

{
  "status": "статус"
}

مثال للإجابة الناجحة:

{
  "status": "success"
}

مثال للإجابة التي تحتوي على خطأ:

{
  "status": "error",
  "error": "CANT_CANCEL"
}

الأخطاء المحتملة:
BAD_KEY – تحقق من مفتاح API الخاص بك;
NO_ID_RENT – تحقق من معرف الإيجار;
INVALID_PHONE – معرف الإيجار غير موجود;
INCORECT_STATUS – تحقق من حالة الإيجار;
ALREADY_FINISH – لقد تم الانتهاء بالفعل من عملية الإيجار;
ALREADY_CANCEL – لقد تم إلغاء العملية الإيجارية بالفعل;
CANT_CANCEL – لا يمكن إلغاؤه (تمت استلام رسالة قصيرة SMS أو مضى أكثر من 20 دقيقة);
SQL_ERROR – خطأ في خادم SQL، أعد إرسال الطلب لاحقًا;
SERVER_ERROR – خطأ في الخادم، أعد إرسال الطلب لاحقًا;
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى.

$api_key – مفتاح API الخاص بك (الإعدادات);
$id – معرف الإيجار.

ستكون استجابة الخدمة بتنسيق JSON:

{
  "status": "status",
  "quantity": "number of codes",
  "values": {
     "0": {
       "phoneFrom": "phone number",
       "service": "service code",
       "text": "sms code",
       "date": "date of SMS receipt"
    }
  }
}

مثال للإجابة الناجحة:

{
  "status": "success",
  "quantity": "2 ",
  "values": {
    "0 ": {
      "phoneFrom": "66846426435",
      "service": "tg",
      "test": "123456",
      "date": "2023-10-26 11:03:39"
    },
    "1": {
      "phoneFrom ": "66846426435",
      "service": "tg",
      "test": "224444",
      "date": "2023-10-26 11:02:31"
    }
  }
}

مثال للاستجابة الناجحة بقائمة أكواد فارغة:

{
  "status": "success",
  "values":{}
}

مثال للإجابة التي تحتوي على خطأ:

{
  "status": "error",
  "error": "NO_ID_RENT"
}

الأخطاء المحتملة:
BAD_KEY – تحقق من مفتاح API الخاص بك;
NO_ID_RENT – تحقق من معرف الإيجار;
INVALID_PHONE – معرف الإيجار غير موجود;
SERVER_ERROR – خطأ في الخادم، أعد إرسال الطلب لاحقًا;
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى.

$api_key - مفتاح API الخاص بك (يمكن العثور عليه في الإعدادات)
$service - رمز الخدمة
$country - رمز الدولة
$time - مدة الاستئجار (4 ساعات كحد أدنى)

ستكون الاستجابة من الخادم بصيغة JSON:

{ "status": "status", "values": { "Country": { "Service": { "cost": cost, "count": number, "max_hours": maximumRentalHours } } } }

مثال على إجابة ناجحة:

{
  "status": "success",
  "values": {
    "0": {
      "tg": {
        "cost": 12,
        "max_hours": 10,
        "count": 15
      }
    }
  }
}

مثال على إجابة تحتوي على خطأ:

{
  "status": "error",
  "error": "INVALID_TIME"
}

الأخطاء المحتملة:

BAD_KEY - تحقق من مفتاح API الخاص بك
BAD_COUNTRY - تحقق من رمز الدولة
BAD_SERVICE - تحقق من رمز الخدمة
INVALID_TIME - تحقق من عدد الساعات
NO_NUMBERS - كرر الطلب أو اختر دولة أخرى
SERVER_ERROR - خطأ في الخادم، كرر المحاولة لاحقًا
SERVICE_UNAVAILABLE_REGION — الوصول من منطقتك مقيد، يرجى استخدام عنوان IP من منطقة أخرى

$api_key – مفتاح واجهة برمجة التطبيقات الخاص بك (موجود في الإعدادات)
$coin – العملة الرقمية (usdt);
$network – الشبكة (trс-20)

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

  {
        "wallet_address": "TReiqL2AkD1euTgjXmrtKLnwDAbNPgTstU"
    }