API v2.0

API هي بروتوكول التفاعل بين برنامجك وخادم التفعيل الخاص بنا. تُستخدم API لأتمام عملية استلام رسائل SMS للتفعيل من جانبك. لاستخدام API، يجب عليك استخدام مفتاح API الخاص بك، يمكنك الحصول عليه من خلال الانتقال إلى صفحة الملف الشخصي. برنامجنا متوافق تمامًا مع مواقع SMS المنافسة.

وصف بروتوكول API

يجب أن تذهب جميع الطلبات إلى https://api.sms-man.com/control/ طلب POST أو GET. يجب أن تحتوي جميع الطلبات على مفتاح API في شكل معلمة token

طلب الرصيد

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك

النتيجة

{
  "balance": "799.70"
}

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": "Wrong token!"
}

احصل على الحدود

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك
`country_id`	Integer	no
`application_id`	Integer	no

النتيجة

[
  {"application_id":"1","country_id":"1","numbers":"32302"},
  {"application_id":"1","country_id":"2","numbers":"3494"}
]

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": {"token":"Wrong token!"}
}

اطلب رقم هاتف

المعلمات

لاختيار دولة عشوائية، استخدم country_id=0

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك
`country_id`	Integer	no
`application_id`	Integer	yes
`maxPrice`	Integer	no	القيمة المطلوبة الخاصة بك
`currency`	String	no	`RUB/USD/EUR`
`ref`	String	no	قم بتمرير ID الإحالة
`hasMultipleSms`	String	no	`True/False`

النتيجة

{
  "request_id": 1,
  "country_id": 1,
  "application_id": 1,
  "number": "79002415539"
}

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": {"token":"Wrong token!"}
}

احصل على رسائل SMS

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك
`request_id`	Integer	yes	ID الطلب

النتيجة

{
  "request_id": 1,
  "country_id": 1,
  "application_id": 1,
  "number": "79002415539",
  "sms_code": "1243"
}

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

{
  "request_id": 1,
  "country_id": 1,
  "application_id": 1,
  "number": "79002415539",
  "error_code": "wait_sms",
  "error_msg": "Still waiting..."
}

تغيير حالة الطلب

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك
`request_id`	Integer	yes	ID الطلب
`status`	String	yes	`ready` / `close` / `reject` / `used`

النتيجة

{
  "request_id": 1,
  "success": true
}

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": "Wrong token!"
}

{
  "success": false,
  "error_code": "wrong_status",
  "error_msg": "Status $status does not exists"
}

احصل على الأسعار الحالية

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك
`country_id`	Integer	no

النتيجة

{
  "0": {"1":{"cost":"15","count":6455},"2":{"cost":"50","count":124}},
  "1": {"3":{"cost":"6","count":1000}}
}

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": {"token":"Wrong token!"}
}

احصل على قائمة بجميع الدول

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك

النتيجة

[
  {"id":0,"title":"Russia"},
  {"id":3,"title":"China"}
]

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": "Wrong token!"
}

احصل على قائمة بجميع الخدمات

المعلمات

الحقل	النوع	مطلوب	القيمة
`token`	String	yes	مفتاح API الخاص بك

النتيجة

[
  {"id":"1","name":"Vkontakte","code":"vk"},
  {"id":"2","name":"WeChat","code":"wb"},
  {"id":"3","name":"Telegram","code":"tg"}
]

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

{
  "success": false,
  "error_code": "wrong_token",
  "error_msg": "Wrong token!"
}