Розробник DOC WhatsApp

Ця документація стосується лише надсилання повідомлень WhatsApp. Це також можливо надсилати повідомлення WhatsApp і SMS одночасно.

У SMSmobileAPI ми прагнемо зробити наш API максимально сумісним із будь-якою архітектурою чи платформою.
Незалежно від того, чи використовуєте ви REST, SOAP, cURL або різні мови програмування, як-от Python, JavaScript, PHP тощо, наш API створено для бездоганної інтеграції у ваші проекти.

У нас також є готові до використання плагіни для рішень електронної комерції та програмного забезпечення. Натисніть тут, щоб дізнатися про них.

Якщо у вас виникли запитання, пропозиції чи потрібна допомога, наша команда готова допомогти.
Не соромтеся звертатися до нас за адресою api@smsmobileapi.com

API REST

cURL

JavaScript

Python

Node.js

рубін

WSDL

Надіслати WhatsApp API

API SMSMobile підтримує два методи автентифікації: за допомогою простого ключа API або протоколу OAuth2 з ідентифікатором клієнта та секретом клієнта.

1. Автентифікація ключа API для надсилання SMS

Для цього методу потрібен ключ 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 для надсилання SMS

OAuth2 забезпечує більш безпечний і масштабований метод автентифікації.
Вам потрібно буде використовувати ідентифікатор клієнта та секрет клієнта, щоб отримати маркер доступу, який потім слід включити у ваші запити API за допомогою Авторизація заголовок.

Client_id і client_secret доступні на інформаційній панелі після встановлення програми та створення облікового запису на мобільному пристрої.
Завантажте мобільний додаток зараз або отримати доступ до панелі керування.

Отримання маркера доступу

Щоб отримати маркер доступу, надішліть запит 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"

Використання маркера доступу:

Отримавши маркер доступу, додайте його до Авторизація заголовок ваших запитів API:


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

-H "Авторизація: носій abc123xyz456" \

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

-d "одержувачі=+1234567890" \

-d "повідомлення=Привіт"

Який метод слід використовувати?

- Використовуйте Аутентифікація ключа API для швидкої та простої інтеграції.

- Використовуйте Автентифікація OAuth2 для підвищення безпеки та масштабованості ваших інтеграцій.

Для отримання додаткової інформації зверніться до повної документації.

Надіслати повідомлення WhatsApp

WSDL URL

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);

Надіслати WhatsApp

Базова команда 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, передаючи необхідні параметри як асоціативний масив.

Надіслати WhatsApp

Використовуйте наш офіційний модуль Python: https://smsmobileapi.com/python/
або скористайтеся ручним способом...

Використання бібліотеки запитів

Бібліотека `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 і також може використовуватися для взаємодії з вашим API:


        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 до API. Параметри кодуються в URL-адресі та надсилаються з відповідними заголовками.

Надіслати WhatsApp

Використання API `fetch`

API `fetch` — це сучасний і універсальний спосіб робити HTTP-запити в JavaScript. Ось як ви можете використовувати його для надсилання повідомлення WhatsApp через SMSmobileAPI:


        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 за допомогою API `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`.

Надіслати WhatsApp

Використання бібліотеки `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.

Надіслати WhatsApp

Використання бібліотеки `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.