Dev DOC WhatsApp - SMSMobileAPI

هذه الوثيقة خاصة بإرسال رسالة WhatsApp فقط. من الممكن أيضًا إرسال رسالة WhatsApp ورسالة نصية قصيرة في نفس الوقت.

في SMSmobileAPI، نسعى جاهدين لجعل واجهة برمجة التطبيقات الخاصة بنا متوافقة قدر الإمكان مع أي بنية أو منصة.
سواء كنت تستخدم REST أو SOAP أو cURL أو لغات برمجة مختلفة مثل Python أو JavaScript أو PHP والمزيد، فإن واجهة برمجة التطبيقات الخاصة بنا مصممة للتكامل بسلاسة في مشاريعك.

لدينا أيضًا مكونات إضافية جاهزة للاستخدام لحلول وبرامج التجارة الإلكترونية. انقر هنا لاكتشافهم.

إذا كان لديك أي أسئلة أو اقتراحات أو تحتاج إلى مساعدة، فإن فريقنا هنا لمساعدتك.
لا تتردد في التواصل معنا على api@smsmobileapi.com

واجهة برمجة التطبيقات REST

cURL

جافا سكريبت

بايثون

نود.جي اس

روبي

WSDL

إرسال API WhatsApp

تدعم واجهة برمجة تطبيقات SMSMobile طريقتين للمصادقة: استخدام مفتاح API بسيط أو بروتوكول OAuth2 مع معرف العميل وسر العميل.

1. مصادقة مفتاح API لإرسال الرسائل القصيرة

تتطلب هذه الطريقة مفتاح API يمكن تضمينه كمعلمة في طلب GET أو POST. إنها طريقة مباشرة للتحقق من صحة طلبات API الخاصة بك.

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&waonly=yes&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

حدود:

- apikey:مفتاح API الفريد الخاص بك.

- recipients: رقم هاتف المستلم (يجب أن يكون الرقم متاحًا على WhatsApp). أدخل رقم الهاتف الذي يبدأ برمز الدولة (بدون "+" وبدون "00")، متبوعًا مباشرة ببقية رقمك. مثال 191728660

- message:الرسالة المراد إرسالها (أسطر متعددة ممكنة).

- waonly:يجب أن يكون لها القيمة نعم -> مطلوب تحديد أنه يجب إرسال رسالة WhatsApp واحدة فقط

مثال:


        احصل على https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEYY&waonly=yes&recipients=191728660&message=HelloWorld

2. مصادقة OAuth2 لإرسال الرسائل القصيرة

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

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

الحصول على رمز الوصول

للحصول على رمز وصول، أرسل طلب POST إلى نقطة نهاية الرمز باستخدام معرف العميل والسر الخاص بالعميل.


curl -X POST https://api.smsmobileapi.com/oauth2/token \

-H "Content-Type: application/x-www-form-urlencoded" \

-d "grant_type=client_credentials" \

-d "client_id=1ab0ex4b4c1ef2c800690d" \

-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

استخدام رمز الوصول:

بمجرد حصولك على رمز الوصول، قم بتضمينه في التفويض رأس طلبات واجهة برمجة التطبيقات الخاصة بك:


curl -X POST https://api.smsmobileapi.com/sendsms?waonly=yes \

-H "التفويض: الناقل abc123xyz456" \

-H "نوع المحتوى: application/x-www-form-urlencoded" \

-d "المستلمون=+1234567890" \

-d "الرسالة=مرحبا"

ما هي الطريقة التي يجب عليك استخدامها؟

- يستخدم مصادقة مفتاح API للتكامل السريع والمباشر.

- يستخدم مصادقة OAuth2 لتعزيز الأمان وقابلية التوسع في عمليات التكامل الخاصة بك.

لمزيد من التفاصيل، يرجى الرجوع إلى الوثائق الكاملة.

إرسال رسالة واتس اب

عنوان URL لـ WSDL
https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

حدود:

- recipients: رقم الهاتف المحمول للمستلم.

- message: الرسالة المراد إرسالها.

- apikey: مفتاح API الذي لديك أو سوف تتلقاه.

- waonly: يجب أن يكون لها القيمة نعم -> مطلوب تحديد أنه يجب إرسال رسالة WhatsApp واحدة فقط.

مثال


                require_once "lib/nusoap.php";

                

                $client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

                $error  = $client->getError();

                

                $result = $client->call("sendSms", array("waonly" =>"yes","recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));

                

                print_r($result);

أرسل واتساب

أمر cURL الأساسي

بإمكانك استخدام أمر cURL التالي لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        curl -X POST https://api.smsmobileapi.com/sendsms/?waonly=yes \

        -d "recipients=PHONE_NUMBER" \

        -d "message=YOUR_MESSAGE" \

        -d "apikey=YOUR_API_KEY"

مثال cURL في PHP

إذا كنت تستخدم PHP، فإليك كيفية إرسال رسالة WhatsApp باستخدام cURL:


        <?php

        

        $url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        $data = array(

            'recipients' => 'PHONE_NUMBER',

            'message' => 'YOUR_MESSAGE',

            'apikey' => 'YOUR_API_KEY'


        );

        

        $options = array(

            CURLOPT_URL => $url,

            CURLOPT_POST => true,

            CURLOPT_POSTFIELDS => http_build_query($data),

            CURLOPT_RETURNTRANSFER => true,

        );

        

        $ch = curl_init();

        curl_setopt_array($ch, $options);

        $response = curl_exec($ch);

        curl_close($ch);

        

        echo $response;

        

        ?>

يوضح مثال PHP هذا كيفية إرسال طلب POST باستخدام cURL إلى SMSmobileAPI، وتمرير المعلمات الضرورية كمصفوفة ارتباطية.

أرسل واتساب

استخدم وحدة Python الرسمية الخاصة بنا: https://smsmobileapi.com/python/
أو استخدم الطريقة اليدوية ...

استخدام مكتبة `requests`

مكتبة `requests` هي مكتبة HTTP شائعة وبسيطة للغة Python. وإليك كيفية استخدامها لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        import requests



        url = "https://api.smsmobileapi.com/sendsms/waonly=yes"



        payload = {

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        }



        response = requests.post(url, data=payload)



        print(response.text)

يوضح هذا المثال طلب POST بسيطًا إلى SMSmobileAPI، لإرسال رسالة WhatsApp إلى رقم هاتف محدد.

استخدام مكتبة `http.client`

تعتبر المكتبة `http.client` مضمنة في مكتبة Python القياسية ويمكن أيضًا استخدامها للتفاعل مع واجهة برمجة التطبيقات الخاصة بك:


        import http.client

        import urllib.parse



        conn = http.client.HTTPSConnection("api.smsmobileapi.com")



        params = urllib.parse.urlencode({

            "recipients": "PHONE_NUMBER",

            "message": "YOUR_MESSAGE",

            "apikey": "YOUR_API_KEY"

        })



        headers = { "Content-type": "application/x-www-form-urlencoded" }



        conn.request("POST", "/sendsms/?waonly=yes", params, headers)

        response = conn.getresponse()

        data = response.read()



        print(data.decode("utf-8"))

        conn.close()

يوضح هذا المثال كيفية استخدام مكتبة `http.client` لإرسال طلب POST إلى واجهة برمجة التطبيقات. يتم ترميز المعلمات بصيغة URL وإرسالها مع الرؤوس المناسبة.

أرسل واتساب

استخدام واجهة برمجة التطبيقات `fetch`

تُعد واجهة برمجة التطبيقات "fetch" طريقة حديثة ومتعددة الاستخدامات لإرسال طلبات HTTP في JavaScript. وإليك كيفية استخدامها لإرسال رسالة WhatsApp عبر واجهة برمجة تطبيقات SMSmobile:


        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = {

            recipients: "PHONE_NUMBER",

            message: "YOUR_MESSAGE",

            apikey: "YOUR_API_KEY"

        };



        fetch(url, {

            method: "POST",

            headers: {

                "Content-Type": "application/x-www-form-urlencoded"

            },

            body: new URLSearchParams(data)

        })

        .then(response => response.text())

        .then(result => console.log(result))

        .catch(error => console.error("Error:", error));

يوضح هذا المثال كيفية إرسال طلب POST باستخدام واجهة برمجة التطبيقات `fetch`، والتي تدعمها معظم المتصفحات الحديثة.

استخدام `XMLHttpRequest`

إذا كنت بحاجة إلى دعم المتصفحات القديمة، فيمكنك استخدام الكائن `XMLHttpRequest`:


        const xhr = new XMLHttpRequest();

        const url = "https://api.smsmobileapi.com/sendsms/?waonly=yes";



        const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";



        xhr.open("POST", url, true);

        xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");



        xhr.onreadystatechange = function() {

            if (xhr.readyState === 4 && xhr.status === 200) {

                console.log(xhr.responseText);

            }

        };



        xhr.send(data);

يوضح هذا المثال كيفية استخدام `XMLHttpRequest` لإرسال طلب POST، مما يوفر التوافق مع المتصفحات القديمة التي قد لا تدعم `fetch`.

أرسل واتساب

استخدام مكتبة `axios`

تُعد مكتبة `axios` عميل HTTP شائعًا لـ Node.js. وإليك كيفية استخدامها لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        const axios = require('axios');



        const url = 'https://api.smsmobileapi.com/sendsms/?waonly=yes';

        const data = {

            recipients: 'PHONE_NUMBER',

            message: 'YOUR_MESSAGE',

            apikey: 'YOUR_API_KEY'

        };



        axios.post(url, data)

        .then(response => {

            console.log(response.data);

        })

        .catch(error => {

            console.error('Error:', error);

        });

يوضح هذا المثال كيفية إرسال طلب POST باستخدام `axios` في Node.js للتفاعل مع SMSmobileAPI.

أرسل واتساب

استخدام مكتبة `Net::HTTP`

بإمكانك استخدام مكتبة `Net::HTTP` في Ruby لإرسال رسالة WhatsApp عبر SMSmobileAPI:


        require 'net/http'

        require 'uri'



        uri = URI.parse("https://api.smsmobileapi.com/sendsms/?waonly=yes")

        request = Net::HTTP::Post.new(uri)

        request.set_form_data(

            "recipients" => "PHONE_NUMBER",

            "message" => "YOUR_MESSAGE",

            "apikey" => "YOUR_API_KEY"

        )



        req_options = {

            use_ssl: uri.scheme == "https",

        }



        response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|

            http.request(request)

        end



        puts response.body

يوضح هذا المثال كيفية إرسال طلب POST باستخدام `Net::HTTP` في Ruby إلى SMSmobileAPI.

إرسال API WhatsApp

1. مصادقة مفتاح API لإرسال الرسائل القصيرة

حدود:

مثال:

2. مصادقة OAuth2 لإرسال الرسائل القصيرة

الحصول على رمز الوصول

استخدام رمز الوصول:

ما هي الطريقة التي يجب عليك استخدامها؟

إرسال رسالة واتس اب

عنوان URL لـ WSDL https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

حدود:

مثال

أرسل واتساب

أمر cURL الأساسي

مثال cURL في PHP

أرسل واتساب

استخدام مكتبة `requests`

استخدام مكتبة `http.client`

أرسل واتساب

استخدام واجهة برمجة التطبيقات `fetch`

استخدام `XMLHttpRequest`

أرسل واتساب

استخدام مكتبة `axios`

أرسل واتساب

استخدام مكتبة `Net::HTTP`

عنوان URL لـ WSDL
https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl