شركة التواصل الرقمية / 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 - عربي

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

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"
    }
}

الرابط: 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

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

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


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

الرابط: 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

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

استجابة ناجحة (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"
    }
}

الرابط: 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