تم تصميم بروتوكول الشركاء لتوفير أرقام الهواتف والرسائل القصيرة الواردة عبر واجهة برمجة التطبيقات (API) مباشرة إلى خادم Grizzly SMS.
تتضمن جميع الطلبات المعامل KEY. يتم توفير هذه المفتاح من قِبل فريق الدعم وهو متاح في الحساب الشخصي.
طلبات الكمية GET_SERVICES وطلبات الأرقام GET_NUMBER وطلبات إنهاء التفعيل FINISH_ACTIVATION تُرسل مباشرةً من خادمنا إلى خادم الشريك.
تنسيق عنوان الـ URL: https://GrizzlySMS حيث يمكن أن يكون GrizzlySMS هو partner.ru:port/GrizzlySMS.php أو partner.ru/GrizzlySMS.php.
- GET_SERVICES
- GET_NUMBER
- PUSH_SMS
- FINISH_ACTIVATION
- يقوم خادم Grizzly SMS بإرسال طلب للحصول على عدد أرقام الهواتف المتاحة باستخدام طريقة GET_SERVICES تقريبًا كل 10–20 ثانية.
- إذا قمت بالرد بعدد > 0، فستتلقى طلبًا لإصدار رقم هاتف باستخدام طريقة GET_NUMBER.
- بعد استلام طلب GET_NUMBER يجب عليك تزويدنا برقم هاتف يستوفي جميع المعايير وإعادة توجيه جميع الرسائل القصيرة الواردة إلينا باستخدام طريقة PUSH_SMS. هذا ضروري لتمكيننا من تنفيذ ترشيح واضح وموضوعي وتسليم الرسائل القصيرة ذات الصلة إلى الخدمة الصحيحة لعملائنا.
- بعد إكمال جميع الإجراءات اللازمة المتعلقة برقم الهاتف، ستتلقى الحالة 3 من خلال طريقة FINISH_ACTIVATION. تشير هذه الحالة إلى أنه تم استخدام الرقم بنجاح للتسجيل وقد تم مكافأتك عليه.
المتطلبات:
- تنسيق الطلب/الاستجابة: JSON
- الترميز: UTF-8
- يجب دائمًا استخدام ترويسة user-agent في الطلبات المرسلة إلى خادم Grizzly SMS
أنواع الحقول:
- int: قيمة عدد صحيح في النطاق من -2 147 483 648 إلى 2 147 483 647
- Uint: قيمة عدد صحيح غير سالب في النطاق من 0 إلى 2 147 483 647
- long: قيمة عدد صحيح في النطاق من -9 223 372 036 854 775 808 إلى 9 223 372 036 854 775 807
- Ulong: قيمة عدد صحيح طويل غير سالب في النطاق من 0 إلى 9 223 372 036 854 775 807
- cur: قيمة عددية حقيقية تحتوي على ما يصل إلى منزلتين عشريتين، مثل 177.77
- boolean: القيمتان المنطقيتان true أو false
- string: قيمة نصية بطول غير محدود
- array of string: مصفوفة من السلاسل النصية
