طي المحتوى

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

تفعيل API
واجهة برمجة تطبيقات التنشيط: طلب رقم
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getNumber&service=$service&country=$country

&action=getNumber
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;
$service — رمز الخدمة;
$country — رمز البلد.
إذا لم يتم تحديده، فسيتم اختيار الرقم الروسي افتراضيًا.

الأخطاء المحتملة:
BAD_KEY — تحقق من مفتاح واجهة برمجة التطبيقات (API key) الخاص بك;
NO_NUMBERS — كرر الطلب أو اختر بلدًا آخر.
the number has not been issued — كرر الطلب أو حدد بلدًا آخر

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

ACCESS_NUMBER:38496653:66846426435

حيث يمثل 38496653 معرّف التنشيط، و66846426435 هو رقم الهاتف.

جرب هذه الطريقة الآن
Your API key
Service code
Country code
تفعيل API
واجهة برمجة تطبيقات التنشيط: تغييرات حالة التنشيط

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 — إجراء غير صحيح

جرب هذه الطريقة الآن
Your API key
Activation id
Activation status
تفعيل API
واجهة برمجة تطبيقات التنشيط: الحصول على حالة التنشيط

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 — إجراء غير صحيح

جرب هذه الطريقة الآن
Your API key
Activation id
تفعيل API
واجهة برمجة تطبيقات التنشيط: طلب الرصيد
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getBalance

&action=getBalance
$api_key — (الإعدادات) مفتاح واجهة برمجة التطبيقات الخاص بك;

استجابة الخدمة:
ACCESS_BALANCE:$balance (حيث يكون $balance هو رصيد الحساب)

الأخطاء المحتملة:
BAD_KEY — مفتاح واجهة برمجة التطبيقات غير صالح

جرب هذه الطريقة الآن
Your API key
تفعيل API
واجهة برمجة تطبيقات التنشيط: الحصول على الأسعار الحالية بحسب البلد
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getPrices&service=$service&country=$country

&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
    }
  }
}
جرب هذه الطريقة الآن
Your API key
Service code
Country code
API الاستئجار
واجهة تأجير API: طلب رقم

https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentNumber&service=$service&country=$country&rent_time=$time

$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 – خطأ في الخادم، أعد إرسال الطلب لاحقًا.

جرب هذه الطريقة الآن
Your API-key
Service code
Country code
Rental time (min. of 4 hours)
API الاستئجار
واجهة تأجير API: استمرار الإيجار
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=continueRentNumber&id=$id&rent_time=$time

$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 – خطأ في الخادم، أعد إرسال الطلب لاحقًا.

جرب هذه الطريقة الآن
Your API-key (Settings)
Rental time (min. of 4 hours)
API الاستئجار
واجهة تأجير API: تاريخ الإيجار
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentHistory&id=$id

$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، أعد إرسال الطلب لاحقًا.

جرب هذه الطريقة الآن
Your API-key
ID rent
API الاستئجار
واجهة تأجير API: تغيرات حالة الإيجار
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=setRentStatus&id=$id&status=$status

$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 – خطأ في الخادم، أعد إرسال الطلب لاحقًا.

جرب هذه الطريقة الآن
Your API-key
ID rent
Rent status
API الاستئجار
واجهة تأجير API: الحصول على حالة التنشيط
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentStatus&id=$id

$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 – خطأ في الخادم، أعد إرسال الطلب لاحقًا.

جرب هذه الطريقة الآن
Your API-key
ID rent
API الاستئجار
واجهة برمجة التطبيقات للإيجار: الحصول على الأسعار الحالية حسب الدولة ملاحظات:
https://api.grizzlysms.com/stubs/handler_api.php?api_key=$api_key&action=getRentPrices&service=$service&country=$country&rent_time=$time

$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 - خطأ في الخادم، كرر المحاولة لاحقًا

جرب هذه الطريقة الآن
Your API-key
Service code
Country code
Rental time (min. of 4 hours)