شركة التواصل الرقمية / API

الرابط: https://api.tawasolsms.com/index.php?user=user1&pass=123456&sid=Tawasol&mno=916xxxxxxxx1&text=test sms&type=1
طريقة الطلب: GET

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

المعلمات (PARAMS)

الاسم	القيمة	الوصف
user	user1	اسم المستخدم
pass	123456	كلمة المرور
sid	Tawasol	معرف المرسل
mno	966xxxxxxxx1	رقم الهاتف المحمول
text	test sms	محتوى الرسالة
type	1	نوع الرسالة: 1 - إنجليزي 2 - يونيكود 3 - رموز خاصة 4 - عربي

في حال الفشل (الأخطاء المحتملة):

عند فشل الطلب، يقوم النظام بإرجاع رمز حالة محدد يشير إلى نوع الخطأ الذي تم حدوثه. أدناه قائمة برموز الأخطاء مع وصف موجز لكل منها لمساعدتك في التعرف على المشكلة وحلها.

Name	Description
ERROR - HTTP01	Invalid HTTP URL Format
ERROR - HTTP02	Invalid query string
ERROR - HTTP03	Message Submission Failed2
ERROR - HTTP04	Invalid Password
ERROR - HTTP05	Invalid System ID
ERROR - HTTP06	Invalid Sender ID
ERROR - HTTP07	Invalid Type
ERROR - HTTP08	Invalid Message ID
ERROR - HTTP09	Invalid Destination Address
ERROR - HTTP10	Invalid number of messages
ERROR - HTTP11	Requested service is unavailable
ERROR - HTTP12	Submit Failed
ERROR - HTTP13	Query request failed
ERROR - HTTP14	Bind failed
ERROR - HTTP15	Not Authorized for the request.
ERROR - HTTP16	Invalid Request
ERROR - HTTP17	Invalid Message Length
ERROR - HTTP18	INSUFFICIENT CREDITS/BALANCE
ERROR - HTTP19	Invalid DATA CODING SCHEME
ERROR - HTTP20	Invalid ESM
ERROR - HTTP21	Invalid HEADER
ERROR - HTTP22	Invalid Schedule Time
ERROR - HTTP23	Routing Error
ERROR - HTTP24	Exceeded number of Destination
ERROR - HTTP25	No Record Found
ERROR - HTTP26	Account Expired

مثال على الطلب:

Url: https://api.tawasolsms.com/index.php?user=user1&pass=123456&sid=Tawasol&mno=916xxxxxxxx1&text=test sms&type=1
Method: GET

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


{
    "success": "true",
    "message": "ok",
    "errorCode": "ER-00",
    "data": {
        "MessageID": [
            "2503201507578527991"
        ],
        "MessageContent": "test sms",
        "Status": "Sent",
        "totalSms": 1,
        "totalRecipients": 1,
        "Balance": "Not requested",
        "Recipient": "966xxxxxxxxx1",
        "TimeCreated": "2025-03-20 15:07:57"
    }
}

فشل الاستجابة


{
    "success": "false",
    "message": "ERROR - HTTP07 --> نوع غير صالح",
    "ip": "1.2.3.4",
    "errorCode": "ER-01",
    "data": []
}

الرابط: https://api.tawasolsms.com/dlr.php?message_id=2503101521175975331
طريقة الطلب: GET

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

المعلمات (PARAMS)

الاسم	القيمة	الوصف
username	user	username
password	1234567	password
message_id	2503101521175975331	Message Id

مثال على الطلب:

url: https://api.tawasolsms.com/dlr.php?message_id=2503101521175975331
Method: GET

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


{
    "success": true,
    "message_id": "2503101521175975331",
    "status": "DELIVRD",
    "message": "ok",
    "errorCode": "ER-00"
}

الرابط: https://api.tawasolsms.com/balance.php
طريقة الطلب: GET

من خلال واجهة برمجة التطبيقات (API) للحصول على رصيدك الحالي، يمكنك استرداد رصيد حسابك مباشرة.

مثال على الطلب:

url: https://api.tawasolsms.com/balance.php
Method: GET

form data

Name	Value
username	user
password	123123

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


{
    "success": "true",
    "message": "ok",
    "errorCode": "ER-00",
    "data": {
        "Username": "user",
        "Balance": "964"
    }
}

الرابط: https://api.tawasolsms.com/group.php?user=user&pass=1234567&sid=TawasolSMS&group=gr3&limit=5&type=1&text=test group sms
طريقة الطلب: GET

تتيح هذه الواجهة البرمجية (API) للمستخدمين إرسال رسالة نصية قصيرة (SMS) إلى مجموعة محددة مسبقًا من جهات الاتصال. يتم إرسال الرسالة باستخدام معرف المرسل المحدد، مع إمكانية تحديد عدد معين من المستلمين لكل طلب.

مثال على الطلب:

url: https://api.tawasolsms.com/group.php?user=user&pass=1234567&sid=TawasolSMS&group=gr3&limit=5&type=1&text=test group sms
Method: GET

form data

Name	Value
username	user
password	1234567
sid	TawasolSMS
group	gr3
limit	5
type	1
text	test group sms

في حال الفشل (الأخطاء المحتملة):

عند فشل الطلب، يقوم النظام بإرجاع رمز حالة محدد يشير إلى نوع الخطأ الذي تم حدوثه. أدناه قائمة برموز الأخطاء مع وصف موجز لكل منها لمساعدتك في التعرف على المشكلة وحلها.

Name	Description
ERROR - HTTP01	Invalid HTTP URL Format
ERROR - HTTP02	Invalid query string
ERROR - HTTP03	Message Submission Failed2
ERROR - HTTP04	Invalid Password
ERROR - HTTP05	Invalid System ID
ERROR - HTTP06	Invalid Sender ID
ERROR - HTTP07	Invalid Type
ERROR - HTTP08	Invalid Message ID
ERROR - HTTP09	Invalid Destination Address
ERROR - HTTP10	Invalid number of messages
ERROR - HTTP11	Requested service is unavailable
ERROR - HTTP12	Submit Failed
ERROR - HTTP13	Query request failed
ERROR - HTTP14	Bind failed
ERROR - HTTP15	Not Authorized for the request.
ERROR - HTTP16	Invalid Request
ERROR - HTTP17	Invalid Message Length
ERROR - HTTP18	INSUFFICIENT CREDITS/BALANCE
ERROR - HTTP19	Invalid DATA CODING SCHEME
ERROR - HTTP20	Invalid ESM
ERROR - HTTP21	Invalid HEADER
ERROR - HTTP22	Invalid Schedule Time
ERROR - HTTP23	Routing Error
ERROR - HTTP24	Exceeded number of Destination
ERROR - HTTP25	No Record Found
ERROR - HTTP26	Account Expired

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


{
    "success": true,
    "message": "ok",
    "errorCode": "ER-00",
    "BatchId": "2003251625414441831"
}

فشل الاستجابة


{
    "success": "false",
    "message": "ERROR - HTTP07 --> نوع غير صالح",
    "ip": "1.2.3.4",
    "errorCode": "ER-01",
    "data": []
}

الرابط: https://api.tawasolsms.com/group-status.php?batch_id=2003251625414441831&user=user1&pass=123456
طريقة الطلب: GET

تمكّن هذه الواجهة البرمجية (API) المستخدمين من الاستعلام عن حالة تسليم الرسائل النصية الجماعية التي تم إرسالها مسبقًا. يوفر تقرير الحالة معلومات تفصيلية، مثل حالة الطلب، وحالة التسليم، وتوقيت الإرسال والاستلام، وأرقام الهواتف المستلمة.

مثال على الطلب:

url:  https://api.tawasolsms.com/group-status.php?batch_id=2003251625414441831&user=user1&pass=123456
Method: GET

form data

Name	Value
username	user1
password	123123
btach_id	2003251625414441831

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


                    Response Success (200 - OK )

{
    "success": true,
    "message": "ok",
    "errorCode": "ER-00",
    "MessageID": {
        "batch_id": "2003251625414441831",
        "report": [
            {
                "request_status": "000",
                "dlr_status": "DELIVRD",
                "done_date": "2025-03-20 16:25:46",
                "messageid": "2503201625438489831",
                "msisdn": "966xxxxxxxxxxx1",
                "submit_date": "2025-03-20 16:25:43"
            },
            {
                "request_status": "000",
                "dlr_status": "DELIVRD",
                "done_date": "2025-03-20 16:25:50",
                "messageid": "2503201625438419821",
                "msisdn": "966xxxxxxxxxx2",
                "submit_date": "2025-03-20 16:25:43"
            }
        ]
    }
}

الرابط: https://api.tawasolsms.com/index.php?user=user1&pass=123456&sid=TawasolSMS&mno=966xxxxxxxxxx1&text=test sms&type=1&schtime=202524031400&gmt=+0200
طريقة الطلب: GET

تتيح هذه API للمستخدمين إرسال وجدولة رسائل SMS عبر طلب GET بسيط. توفر هذه API طريقة سهلة لجدولة الرسائل لإرسالها في وقت لاحق. سيتم استخدام ScheduleId الذي يتم استلامه في الاستجابة عند جدولة رسالة SMS في Remove Schedule API لإلغاء الرسالة المجدولة قبل إرسالها.

مثال على الطلب:

الرابط:  https://api.tawasolsms.com/index.php?user=user1&pass=123456&sid=TawasolSMS&mno=966xxxxxxxxxx1&text=test sms&type=1&schtime=202524031400&gmt=+0200
الطريقة: GET

بيانات النموذج

الاسم	القيمة
username	user1
password	123456
sid	TawasolSMS
mno	966xxxxxxxxxx1
text	text sms
type	1
schtime	202520031400
gmt	+0200

في حال الفشل (الأخطاء المحتملة):

عند فشل الطلب، يقوم النظام بإرجاع رمز حالة محدد يشير إلى نوع الخطأ الذي تم حدوثه. أدناه قائمة برموز الأخطاء مع وصف موجز لكل منها لمساعدتك في التعرف على المشكلة وحلها.

Name	Description
ERROR - HTTP01	Invalid HTTP URL Format
ERROR - HTTP02	Invalid query string
ERROR - HTTP03	Message Submission Failed2
ERROR - HTTP04	Invalid Password
ERROR - HTTP05	Invalid System ID
ERROR - HTTP06	Invalid Sender ID
ERROR - HTTP07	Invalid Type
ERROR - HTTP08	Invalid Message ID
ERROR - HTTP09	Invalid Destination Address
ERROR - HTTP10	Invalid number of messages
ERROR - HTTP11	Requested service is unavailable
ERROR - HTTP12	Submit Failed
ERROR - HTTP13	Query request failed
ERROR - HTTP14	Bind failed
ERROR - HTTP15	Not Authorized for the request.
ERROR - HTTP16	Invalid Request
ERROR - HTTP17	Invalid Message Length
ERROR - HTTP18	INSUFFICIENT CREDITS/BALANCE
ERROR - HTTP19	Invalid DATA CODING SCHEME
ERROR - HTTP20	Invalid ESM
ERROR - HTTP21	Invalid HEADER
ERROR - HTTP22	Invalid Schedule Time
ERROR - HTTP23	Routing Error
ERROR - HTTP24	Exceeded number of Destination
ERROR - HTTP25	No Record Found
ERROR - HTTP26	Account Expired

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


{
    "success": "true",
    "message": "ok",
    "errorCode": "ER-00",
    "data": {
        "ScheduleId": [
            "2403251328015777624"
        ],
        "MessageContent": "test sms",
        "Status": "Sent",
        "totalSms": 1,
        "totalRecipients": 1,
        "Balance": "Not requested",
        "Recipient": "966xxxxxxx1",
        "TimeCreated": "2025-03-24 13:28:01"
    }
}

فشل الاستجابة


{
    "success": "false",
    "message": "ERROR - HTTP07 --> نوع غير صالح",
    "ip": "1.2.3.4",
    "errorCode": "ER-01",
    "data": []
}

الرابط: https://api.tawasolsms.com/schedule-remove.php?schedule_id=2403251328015777624&user=user&pass=123456
طريقة الطلب: GET

كنك بسهولة التحكم في الرسائل القصيرة المجدولة باستخدام ميزة إزالة الجدولة في واجهة API البسيطة. يتيح لك هذا الخيار حذف الرسائل المجدولة بسرعة من خلال طلب GET بسيط.

مثال على الاستجابة:

Url: https://api.tawasolsms.com/schedule-remove.php?schedule_id=2403251328015777624&user=user&pass=123456
Method: GET

form data

Name	Value
username	user
password	123456
schedule_id	2403251328015777624

مثال على الاستجابة:

Response Success (200 - OK )


{
    "success": true,
    "message": "ok",
    "errorCode": "ER-00",
    "ScheduleId": "2403251328015777624"
}

الرابط: https://api.tawasolsms.com/messages.php
طريقة الطلب: GET

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

مثال على الطلب:

url: https://api.tawasolsms.com/messages.php
Method: GET

BODY formdata

الاسم	القيمة
username	user
password	123456
pageLength	10
pageNumber	1
fromDate	2025-03-27 00:00:00
toDate	2025-05-27 23:00:00

مثال على الاستجابة:

استجابة ناجحة (200 - OK)


{
    "success": "true",
    "message": "ok",
    "errorCode": "ER-00",
    "fromDate": "2025-03-27 00:00:00",
    "toDate": "2025-05-27 23:00:00",
    "data": [
        {
            "msg_id": "2503281153057805971",
            "mccmnc": "2400",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-28 11:53:05",
            "sender": "TawasolSMS",
            "destination": "966xxxxxx1"
        },
        {
            "msg_id": "2503281152376535961",
            "mccmnc": "2400",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-28 11:52:37",
            "sender": "Tawasol",
            "destination": "966xxxxxx1"
        },
        {
            "msg_id": "2503271642304125651",
            "mccmnc": "2400",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 16:42:30",
            "sender": "tawasol-AD",
            "destination": "966xxxxxx1"
        },
        {
            "msg_id": "2503271641018805621",
            "mccmnc": "2400",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 16:41:01",
            "sender": "tawasol-AD",
            "destination": "966xxxxxx18"
        },
        {
            "msg_id": "2503271622375065591",
            "mccmnc": "41501",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 16:22:37",
            "sender": "tawasol-AD",
            "destination": "966xxxxxxxx4"
        },
        {
            "msg_id": "2503271620409775581",
            "mccmnc": "41501",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 16:20:40",
            "sender": "-ad",
            "destination": "966xxxxxxxx4"
        },
        {
            "msg_id": "2503271620142575571",
            "mccmnc": "41501",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 16:20:14",
            "sender": "-ad",
            "destination": "966xxxxxxxx4"
        },
        {
            "msg_id": "2503271558469465381",
            "mccmnc": "2400",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 15:58:46",
            "sender": "TawasolSMS",
            "destination": "966xxxxx3"
        },
        {
            "msg_id": "2503271558469425371",
            "mccmnc": "41503",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 15:58:46",
            "sender": "TawasolSMS",
            "destination": "966xxxxx2"
        },
        {
            "msg_id": "2503271317065042241",
            "mccmnc": "2400",
            "country": "Saudi Arabia",
            "operator": "Zain",
            "time": "2025-03-27 13:17:06",
            "sender": "TawasolSMS",
            "destination": "966xxxxxx1"
        }
    ],
    "pagination": {
        "total": 22,
        "current_page": 1,
        "page_length": 10,
        "total_pages": 3
    }
}

GET إرسال API بسيط باستخدام معلمات URL

GET واجهة API بسيطة للحصول على تفاصيل الرسالة

GET واجهة API بسيطة للحصول على رصيد الحساب

GET إرسال رسائل SMS جماعية عبر API بسيط

GET حالة المجموعة عبر واجهة API بسيطة

GET إرسال الرسائل وجدولتها عبر API بسيط

GET إلغاء الجدولة عبر API بسيط

GET واجهة برمجة تطبيقات بسيطة لاسترجاع رسائل SMS