Dev DOC WhatsApp - SMSMobileAPI

Αυτή η τεκμηρίωση αφορά μόνο την αποστολή μηνύματος WhatsApp. Είναι επίσης δυνατό να στείλτε ένα μήνυμα WhatsApp και ένα SMS ταυτόχρονα.

Στην SMSmobileAPI, προσπαθούμε να κάνουμε το API μας όσο το δυνατόν πιο συμβατό με οποιαδήποτε αρχιτεκτονική ή πλατφόρμα.
Είτε χρησιμοποιείτε REST, SOAP, cURL ή διάφορες γλώσσες προγραμματισμού όπως Python, JavaScript, PHP και άλλες, το API μας έχει σχεδιαστεί για να ενσωματώνεται απρόσκοπτα στα έργα σας.

Έχουμε επίσης έτοιμα προς χρήση πρόσθετα για λύσεις και λογισμικό ηλεκτρονικού εμπορίου. Κάντε κλικ εδώ για να τα ανακαλύψετε.

Εάν έχετε οποιεσδήποτε ερωτήσεις, προτάσεις ή χρειάζεστε βοήθεια, η ομάδα μας είναι εδώ για να σας βοηθήσει.
Μη διστάσετε να επικοινωνήσετε μαζί μας στο api@smsmobileapi.com

API REST

cURL

JavaScript

Πύθων

Node.js

Ρουμπίνι

WSDL

Αποστολή WhatsApp API

Το SMSMobile API υποστηρίζει δύο μεθόδους ελέγχου ταυτότητας: χρησιμοποιώντας ένα απλό κλειδί API ή το πρωτόκολλο OAuth2 με αναγνωριστικό πελάτη και μυστικό πελάτη.

1. API Key Authentication για αποστολή 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"

Χρήση του Access Token:

Μόλις έχετε το διακριτικό πρόσβασης, συμπεριλάβετέ το στο Εξουσιοδότηση κεφαλίδα των αιτημάτων σας API:


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

-H "Εξουσιοδότηση: Bearer abc123xyz456" \

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

-d "recipients=+1234567890" \

-d "message=Hello"

Ποια μέθοδο πρέπει να χρησιμοποιήσετε;

- Χρήση Έλεγχος ταυτότητας κλειδιού API για γρήγορες και άμεσες ενσωματώσεις.

- Χρήση Έλεγχος ταυτότητας OAuth2 για βελτιωμένη ασφάλεια και επεκτασιμότητα στις ενσωματώσεις σας.

Για περισσότερες λεπτομέρειες, ανατρέξτε στην πλήρη τεκμηρίωση.

Στείλτε μήνυμα WhatsApp

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

Στείλτε 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/
ή χρησιμοποιήστε τον τρόπο manual...

Χρήση της βιβλιοθήκης «αιτημάτων».

Η βιβλιοθήκη « αιτημάτων » είναι μια δημοφιλής και απλή βιβλιοθήκη 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".

Το «fetch» API είναι ένας σύγχρονος και ευέλικτος τρόπος για να κάνετε αιτήματα 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.