Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

Chez SMSmobileAPI, nous nous efforçons de rendre notre API aussi compatible que possible avec n'importe quelle architecture ou plate-forme.
Que vous utilisiez REST, SOAP, cURL ou divers langages de programmation comme Python, JavaScript, PHP, etc., notre API est conçue pour s'intégrer de manière transparente à vos projets.

Nous disposons également de plugins prêts à l'emploi pour les solutions et logiciels de commerce électronique. Cliquez ici pour les découvrir.

Si vous avez des questions, des suggestions ou besoin d'aide, notre équipe est là pour vous aider.
N'hésitez pas à nous contacter à api@smsmobileapi.com

API REST

cURL

JavaScript

Python

Node.js

Rubis

WSDL

API d'envoi de SMS

Ce point de terminaison API permet d'envoyer un SMS via une requête HTTP depuis le smartphone.

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

Paramètres:

- recipients: Le numéro de portable du destinataire.

- message : Le message à envoyer.

- apikey : La clé API que vous possédez ou que vous allez recevoir.

Note:

En raison des obligations liées à l'utilisation du téléphone et des politiques d'Android, nous sommes obligés d'augmenter le délai entre l'envoi de deux SMS si l'application est exécutée en arrière-plan ou est fermée. Les messages SMS peuvent toujours être envoyés même lorsque l'application mobile est fermée, mais cela entraînera un délai d'envoi plus long.

Obtenir l'API SMS

Ce point de terminaison API est utilisé pour récupérer les messages SMS reçus sur le smartphone.

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

Paramètre:

- apikey : La clé API.

Envoyer un SMS

URL WSDL

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

Paramètres:

- recipients: Le numéro de portable du destinataire.

- message : Le message à envoyer.

- apikey : La clé API que vous possédez ou que vous allez recevoir.

Exemple

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

Envoyer un SMS

Commande cURL de base

Vous pouvez utiliser la commande cURL suivante pour envoyer un SMS via SMSmobileAPI :

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

Exemple cURL en PHP

Si vous utilisez PHP, voici comment vous pouvez envoyer un SMS en utilisant 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;
 
 ?>

Cet exemple PHP montre comment envoyer une requête POST en utilisant cURL à SMSmobileAPI, en passant les paramètres nécessaires sous forme de tableau associatif.

Envoyer un SMS

Utilisez notre module Python officiel : https://smsmobileapi.com/python/
ou utiliser la méthode manuelle ...

Utilisation de la bibliothèque « requests »

La bibliothèque `requests` est une bibliothèque HTTP populaire et simple pour Python. Voici comment vous pouvez l'utiliser pour envoyer un SMS via 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)

Cet exemple illustre une requête POST simple adressée à SMSmobileAPI, envoyant un message à un numéro de téléphone spécifique.

Utilisation de la bibliothèque « http.client »

La bibliothèque `http.client` est incluse dans la bibliothèque standard de Python et peut également être utilisée pour interagir avec votre 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()

Cet exemple montre comment utiliser la bibliothèque `http.client` pour envoyer une requête POST à l'API. Les paramètres sont codés en URL et envoyés avec les en-têtes appropriés.

Envoyer un SMS

Utilisation de l'API « fetch »

L'API `fetch` est une méthode moderne et polyvalente pour effectuer des requêtes HTTP en JavaScript. Voici comment vous pouvez l'utiliser pour envoyer un SMS via l'API SMSmobile :

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

Cet exemple montre comment envoyer une requête POST à l'aide de l'API « fetch », qui est prise en charge dans la plupart des navigateurs modernes.

Utilisation de `XMLHttpRequest`

Si vous devez prendre en charge des navigateurs plus anciens, vous pouvez utiliser l'objet `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);

Cet exemple montre comment utiliser `XMLHttpRequest` pour envoyer une requête POST, offrant une compatibilité avec les anciens navigateurs qui peuvent ne pas prendre en charge `fetch`.

Envoyer un SMS

Utilisation de la bibliothèque `axios`

La bibliothèque `axios` est un client HTTP populaire pour Node.js. Voici comment vous pouvez l'utiliser pour envoyer un SMS via 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);
 });

Cet exemple montre comment envoyer une requête POST à l'aide de « axios » dans Node.js pour interagir avec SMSmobileAPI.

Envoyer un SMS

Utilisation de la bibliothèque « Net::HTTP »

Vous pouvez utiliser la bibliothèque `Net::HTTP` dans Ruby pour envoyer un SMS via 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

Cet exemple montre comment envoyer une requête POST en utilisant `Net::HTTP` dans Ruby à SMSmobileAPI.

Cliquez ici pour tester la clé API et le service avec le formulaire simple

Selon la version d'Android installée sur un téléphone mobile, le système d'exploitation peut gêner le bon fonctionnement de l'envoi et de la réception automatique des SMS lorsque l'application SmsMobileApi n'est pas au premier plan.
Ce problème provient d'un processus qui tente de s'exécuter en arrière-plan lorsque l'application n'est pas activement lancée. Cependant, en raison des mesures d'optimisation de la batterie d'Android, qui varient selon les différentes versions, ce processus en arrière-plan peut ne pas démarrer correctement. L'optimisation de la batterie d'Android est conçue pour limiter l'activité en arrière-plan des applications afin de préserver la durée de vie de la batterie, ce qui peut affecter par inadvertance les applications nécessitant des processus en arrière-plan pour fonctionner correctement.

Pour résoudre ce problème, les utilisateurs peuvent configurer manuellement leurs paramètres Android pour permettre à SmsMobileApi d'utiliser les ressources sans restrictions.
Cela implique d'ajuster les paramètres d'optimisation de la batterie pour l'application spécifique, en indiquant essentiellement à Android que SmsMobileApi est autorisé à s'exécuter en arrière-plan et à utiliser les ressources selon les besoins. Ce faisant, l'application devrait pouvoir envoyer et recevoir automatiquement des messages SMS même lorsqu'elle n'est pas l'application active au premier plan. Cet ajustement garantit que le processus d'arrière-plan nécessaire peut fonctionner sans interruption, contournant les fonctionnalités d'optimisation de la batterie qui pourraient autrement empêcher sa bonne exécution.

FAQ pour les développeurs

Comment générer une clé API ?

Description de l'exemple d'accordéonPour générer une clé API, téléchargez notre application sur votre téléphone mobile et créez un compte sans frais. Une clé API sera automatiquement générée et liée à votre téléphone mobile. Vous recevrez également un email avec toutes les informations nécessaires. Ce processus garantit que vous pouvez commencer rapidement et facilement à utiliser nos services avec une configuration minimale.

Où puis-je toujours trouver ma clé API ?

Dans votre application mobile, accédez au menu PARAMÈTRES ou AIDE, où votre clé API est visible à tout moment. Cela garantit que vous pouvez facilement accéder à votre clé API chaque fois que vous en avez besoin pour intégrer ou utiliser nos services.

La création d'une clé API peut-elle être anonyme ?

Oui, nous n'exigeons aucune preuve d'identité pour créer une clé API. La communication entre notre API et votre téléphone mobile est donc 100% anonyme. Cette approche permet aux utilisateurs de préserver leur confidentialité lorsqu'ils utilisent nos services.

Commencez avec SMSmobileAPI dès aujourd'hui !

Découvrez la liberté et la flexibilité de gérer vos services SMS en déplacement. Téléchargez notre application mobile dès maintenant et faites le premier pas vers une intégration transparente des SMS.

Téléchargez l'application