Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

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

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

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

API REST

μπούκλα

JavaScript

Πύθων

Node.js

Ρουμπίνι

WSDL

Αποστολή SMS API

The SMSMobile API supports two authentication methods: using a simple API Key or the OAuth2 protocol with a client ID and client secret.

1. API Key Authentication for Send SMS

This method requires an API Key that can be included as a parameter in either a GET or POST request. It is a straightforward way to authenticate your API requests.

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

Παράμετροι:

- apikey: Your unique API key.

- recipients: The recipient's phone number.

- message: The message to send.

Example:

GET https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=Hello%20World

2. OAuth2 Authentication for Send SMS

OAuth2 provides a more secure and scalable authentication method.
You will need to use a client ID and client secret to obtain an access token, which should then be included in your API requests using the Authorization header.

The client_id and client_secret are available in your dashboard, accessible after installing the app and creating an account on your mobile device.
Download the mobile app now ή access your dashboard.

Obtaining an Access Token

To get an access token, send a POST request to the token endpoint with your client ID and client secret.

 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"

Using the Access Token:

Once you have the access token, include it in the Authorization header of your API requests:

 curl -X POST https://api.smsmobileapi.com/sendsms \
 -H "Authorization: Bearer abc123xyz456" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d "recipients=+1234567890" \
 -d "message=Hello"

Which Method Should You Use?

- Use API Key Authentication for quick and straightforward integrations.

- Use OAuth2 Authentication for enhanced security and scalability in your integrations.

For more details, please refer to the full documentation.

Λήψη SMS API

Αυτό το τελικό σημείο API χρησιμοποιείται για την ανάκτηση μηνυμάτων SMS που λαμβάνονται στο smartphone.

https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

Παράμετρος:

- παραλήπτες: Ο αριθμός κινητού τηλεφώνου του παραλήπτη.

- μήνυμα: Το μήνυμα προς αποστολή.

- apikey: Το κλειδί API που έχετε ή θα λάβετε.

Delete SMS API

This API endpoint is used to delete SMS messages from the server log of SMS Mobile API

https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

Παράμετρος:

- apikey: The API key you have.

- guid_message: The unique ID of the message to delete.

- date_start: If used alone, deletes all messages from the specified day.

- date_start and date_end: Combined to delete messages within a specified period.

Note: The deleted SMS are only those stored in the logs of your mobile app account. SMS on the mobile device itself will not be deleted, as we do not have access to them.

Αποστολή SMS

URL WSDL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

Παράμετροι:

- παραλήπτες: Ο αριθμός κινητού τηλεφώνου του παραλήπτη.

- μήνυμα: Το μήνυμα προς αποστολή.

- apikey: Το κλειδί API που έχετε ή θα λάβετε.

Παράδειγμα

 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("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));
 
 print_r($result);

Αποστολή SMS

Βασική εντολή cURL

Μπορείτε να χρησιμοποιήσετε την ακόλουθη εντολή cURL για να στείλετε ένα SMS μέσω του SMSmobileAPI:

 curl -X POST https://api.smsmobileapi.com/sendsms/ \
 -d "recipients=PHONE_NUMBER" \
 -d "message=YOUR_MESSAGE" \
 -d "apikey=YOUR_API_KEY"

Παράδειγμα cURL στην PHP

Εάν χρησιμοποιείτε PHP, δείτε πώς μπορείτε να στείλετε ένα SMS χρησιμοποιώντας το cURL:

 <?php
 
 $url = 'https://api.smsmobileapi.com/sendsms/';
 $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, μεταβιβάζοντας τις απαραίτητες παραμέτρους ως συσχετιστικό πίνακα.

Αποστολή SMS

Χρησιμοποιήστε την επίσημη ενότητα Python μας: https://smsmobileapi.com/python/
ή χρησιμοποιήστε τον τρόπο manual...

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

Η βιβλιοθήκη « αιτημάτων » είναι μια δημοφιλής και απλή βιβλιοθήκη HTTP για την Python. Δείτε πώς μπορείτε να το χρησιμοποιήσετε για να στείλετε ένα SMS μέσω του SMSmobileAPI:

 import requests

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

 payload = {
     "recipients": "PHONE_NUMBER",
     "message": "YOUR_MESSAGE",
     "apikey": "YOUR_API_KEY"
 }

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

 print(response.text)

Αυτό το παράδειγμα δείχνει ένα απλό αίτημα POST στο SMSmobileAPI, στέλνοντας ένα μήνυμα σε έναν συγκεκριμένο αριθμό τηλεφώνου.

Χρήση της βιβλιοθήκης «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/", params, headers)
 response = conn.getresponse()
 data = response.read()

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

Αυτό το παράδειγμα δείχνει πώς να χρησιμοποιήσετε τη βιβλιοθήκη «http.client» για να στείλετε ένα αίτημα POST στο API. Οι παράμετροι κωδικοποιούνται με URL και αποστέλλονται με τις κατάλληλες κεφαλίδες.

Αποστολή SMS

Χρησιμοποιώντας το API "fetch".

Το «fetch» API είναι ένας σύγχρονος και ευέλικτος τρόπος για να κάνετε αιτήματα HTTP σε JavaScript. Δείτε πώς μπορείτε να το χρησιμοποιήσετε για να στείλετε ένα SMS μέσω του SMSmobileAPI:

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

 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/";

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

Αποστολή SMS

Χρήση της Βιβλιοθήκης `axios`

Η βιβλιοθήκη `axios` είναι ένας δημοφιλής πελάτης HTTP για το Node.js. Δείτε πώς μπορείτε να το χρησιμοποιήσετε για να στείλετε ένα SMS μέσω του SMSmobileAPI:

 const axios = require('axios');

 const url = 'https://api.smsmobileapi.com/sendsms/';
 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.

Αποστολή SMS

Χρήση της βιβλιοθήκης `Net::HTTP`

Μπορείτε να χρησιμοποιήσετε τη βιβλιοθήκη `Net::HTTP` στο Ruby για να στείλετε ένα SMS μέσω του SMSmobileAPI:

 require 'net/http'
 require 'uri'

 uri = URI.parse("https://api.smsmobileapi.com/sendsms/")
 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 με την απλή φόρμα

Ανάλογα με την έκδοση του Android που είναι εγκατεστημένη σε ένα κινητό τηλέφωνο, το λειτουργικό σύστημα μπορεί να εμποδίσει τη σωστή λειτουργία της αυτόματης αποστολής και λήψης μηνυμάτων SMS όταν η εφαρμογή SmsMobileApi δεν βρίσκεται στο προσκήνιο.
Αυτό το ζήτημα προκύπτει από μια διαδικασία που επιχειρεί να εκτελεστεί στο παρασκήνιο όταν η εφαρμογή δεν εκκινείται ενεργά. Ωστόσο, λόγω των μέτρων βελτιστοποίησης της μπαταρίας του Android, τα οποία διαφέρουν σε διαφορετικές εκδόσεις, αυτή η διαδικασία παρασκηνίου ενδέχεται να μην ξεκινήσει σωστά. Η βελτιστοποίηση μπαταρίας του Android έχει σχεδιαστεί για να περιορίζει τη δραστηριότητα στο παρασκήνιο των εφαρμογών για τη διατήρηση της διάρκειας ζωής της μπαταρίας, η οποία μπορεί να επηρεάσει ακούσια εφαρμογές που απαιτούν διαδικασίες παρασκηνίου για να λειτουργήσουν σωστά.

Για την αντιμετώπιση αυτού του ζητήματος, οι χρήστες μπορούν να διαμορφώσουν με μη αυτόματο τρόπο τις ρυθμίσεις τους για Android, ώστε να επιτρέπουν στο SmsMobileApi να χρησιμοποιεί πόρους χωρίς περιορισμούς.
Αυτό περιλαμβάνει την προσαρμογή των ρυθμίσεων βελτιστοποίησης μπαταρίας για τη συγκεκριμένη εφαρμογή, δίνοντας ουσιαστικά οδηγίες στο Android ότι το SmsMobileApi επιτρέπεται να εκτελείται στο παρασκήνιο και να χρησιμοποιεί πόρους όπως απαιτείται. Με αυτόν τον τρόπο, η εφαρμογή θα πρέπει να μπορεί να στέλνει και να λαμβάνει αυτόματα μηνύματα SMS ακόμα και όταν δεν είναι η ενεργή εφαρμογή στο προσκήνιο. Αυτή η προσαρμογή διασφαλίζει ότι η απαραίτητη διαδικασία παρασκηνίου μπορεί να λειτουργεί αδιάκοπα, παρακάμπτοντας τις δυνατότητες βελτιστοποίησης της μπαταρίας που διαφορετικά θα μπορούσαν να εμποδίσουν τη σωστή εκτέλεσή της.

Συχνές ερωτήσεις για προγραμματιστές

Πώς να δημιουργήσετε ένα κλειδί API;

Δείγμα Ακορντεόν ΠεριγραφήΓια να δημιουργήσετε ένα κλειδί API, κατεβάστε την εφαρμογή μας στο κινητό σας τηλέφωνο και δημιουργήστε έναν λογαριασμό χωρίς κόστος. Ένα κλειδί API θα δημιουργηθεί αυτόματα και θα συνδεθεί με το κινητό σας τηλέφωνο. Θα λάβετε επίσης ένα email με όλες τις απαραίτητες πληροφορίες. Αυτή η διαδικασία διασφαλίζει ότι μπορείτε γρήγορα και εύκολα να αρχίσετε να χρησιμοποιείτε τις υπηρεσίες μας με ελάχιστη ρύθμιση.

Πού μπορώ να βρω πάντα το κλειδί API μου;

Στην εφαρμογή για κινητά, μεταβείτε στο μενού ΡΥΘΜΙΣΕΙΣ ή ΒΟΗΘΕΙΑ, όπου το κλειδί API είναι ορατό ανά πάσα στιγμή. Αυτό διασφαλίζει ότι μπορείτε να έχετε εύκολη πρόσβαση στο κλειδί API σας όποτε το χρειάζεστε για την ενοποίηση ή τη χρήση των υπηρεσιών μας.

Μπορεί η δημιουργία ενός κλειδιού API να είναι ανώνυμη;

Ναι, δεν απαιτούμε κανένα αποδεικτικό ταυτότητας για τη δημιουργία κλειδιού API. Επομένως, η επικοινωνία μεταξύ του API μας και του κινητού σας τηλεφώνου είναι 100% ανώνυμη. Αυτή η προσέγγιση επιτρέπει στους χρήστες να διατηρούν το απόρρητό τους ενώ χρησιμοποιούν τις υπηρεσίες μας.

Ξεκινήστε με το SMSmobileAPI σήμερα!

Απολαύστε την ελευθερία και την ευελιξία της διαχείρισης των υπηρεσιών SMS σας εν κινήσει. Κατεβάστε την εφαρμογή μας για κινητά τώρα και κάντε το πρώτο βήμα προς την απρόσκοπτη ενσωμάτωση SMS.

Κατεβάστε την Εφαρμογή