Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

En SMSmobileAPI, nos esforzamos por hacer que nuestra API sea lo más compatible posible con cualquier arquitectura o plataforma.
Ya sea que utilice REST, SOAP, cURL o varios lenguajes de programación como Python, JavaScript, PHP y más, nuestra API está diseñada para integrarse perfectamente en sus proyectos.

También disponemos de complementos listos para usar para soluciones y software de comercio electrónico. Haga clic aquí para descubrirlos.

Si tiene alguna pregunta, sugerencia o necesita ayuda, nuestro equipo está aquí para ayudarlo.
No dude en comunicarse con nosotros en api@smsmobileapi.com

API REST

rizo

JavaScript

Pitón

Node.js

Rubí

WSDL

API para enviar SMS

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

Parámetros:

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

Obtener API de SMS

Este punto final de API se utiliza para recuperar mensajes SMS recibidos en el teléfono inteligente.

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

Parámetro:

- destinatarios: El número de móvil del destinatario.

- mensaje: El mensaje a enviar.

- apikey: La clave API que tienes o recibirás.

Eliminar API de SMS

Este punto final de API se utiliza para eliminar mensajes SMS del registro del servidor de SMS Mobile API

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

Parámetro:

- apikey: La clave API que tienes.

- guid_message: El ID único del mensaje a eliminar.

- date_start: si se usa solo, elimina todos los mensajes del día especificado.

- date_start y date_end: se combinan para eliminar mensajes dentro de un período específico.

Nota: Los SMS eliminados son solo aquellos almacenados en los registros de su cuenta de la aplicación móvil. Los SMS del dispositivo móvil en sí no se eliminarán, ya que no tenemos acceso a ellos.

Enviar SMS

URL WSDL

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

Parámetros:

- destinatarios: El número de móvil del destinatario.

- mensaje: El mensaje a enviar.

- apikey: La clave API que tienes o recibirás.

Ejemplo

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

Enviar SMS

Comando básico de cURL

Puede utilizar el siguiente comando cURL para enviar un SMS a través de SMSmobileAPI:

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

Ejemplo de cURL en PHP

Si estás usando PHP, aquí te mostramos cómo puedes enviar un SMS usando 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;
 
 ?>

Este ejemplo de PHP demuestra cómo enviar una solicitud POST usando cURL a SMSmobileAPI, pasando los parámetros necesarios como una matriz asociativa.

Enviar SMS

Utilice nuestro módulo oficial de Python: https://smsmobileapi.com/python/
o usa el método manual...

Uso de la biblioteca `requests`

La biblioteca `requests` es una biblioteca HTTP sencilla y popular para Python. Aquí se explica cómo se puede usar para enviar un SMS a través de 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)

Este ejemplo demuestra una solicitud POST simple a SMSmobileAPI, enviando un mensaje a un número de teléfono específico.

Uso de la biblioteca `http.client`

La biblioteca `http.client` está incluida en la biblioteca estándar de Python y también se puede utilizar para interactuar con su 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()

Este ejemplo muestra cómo utilizar la biblioteca `http.client` para enviar una solicitud POST a la API. Los parámetros están codificados en URL y se envían con los encabezados correspondientes.

Enviar SMS

Usando la API `fetch`

La API "fetch" es una forma moderna y versátil de realizar solicitudes HTTP en JavaScript. A continuación, se muestra cómo se puede utilizar para enviar un SMS a través de 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));

Este ejemplo demuestra cómo enviar una solicitud POST utilizando la API `fetch`, que es compatible con la mayoría de los navegadores modernos.

Usando `XMLHttpRequest`

Si necesita compatibilidad con navegadores más antiguos, puede utilizar el objeto `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);

Este ejemplo muestra cómo utilizar `XMLHttpRequest` para enviar una solicitud POST, proporcionando compatibilidad con navegadores más antiguos que pueden no soportar `fetch`.

Enviar SMS

Usando la biblioteca `axios`

La biblioteca `axios` es un cliente HTTP popular para Node.js. Aquí se explica cómo se puede utilizar para enviar un SMS a través de 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);
 });

Este ejemplo demuestra cómo enviar una solicitud POST usando `axios` en Node.js para interactuar con SMSmobileAPI.

Enviar SMS

Uso de la biblioteca `Net::HTTP`

Puede utilizar la biblioteca `Net::HTTP` en Ruby para enviar un SMS a través de 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

Este ejemplo demuestra cómo enviar una solicitud POST utilizando `Net::HTTP` en Ruby a SMSmobileAPI.

Haga clic aquí para probar la clave API y el servicio con el formulario simple

Dependiendo de la versión de Android instalada en un teléfono móvil, el sistema operativo puede dificultar el correcto funcionamiento del envío y recepción automático de mensajes SMS cuando la aplicación SmsMobileApi no está en primer plano.
Este problema surge de un proceso que intenta ejecutarse en segundo plano cuando la aplicación no se inicia de forma activa. Sin embargo, debido a las medidas de optimización de la batería de Android, que varían según las distintas versiones, es posible que este proceso en segundo plano no se inicie correctamente. La optimización de la batería de Android está diseñada para limitar la actividad en segundo plano de las aplicaciones para conservar la vida útil de la batería, lo que puede afectar inadvertidamente a las aplicaciones que requieren procesos en segundo plano para funcionar correctamente.

Para solucionar este problema, los usuarios pueden configurar manualmente sus ajustes de Android para permitir que SmsMobileApi utilice recursos sin restricciones.
Esto implica ajustar la configuración de optimización de la batería para la aplicación específica, básicamente indicando a Android que SmsMobileApi puede ejecutarse en segundo plano y utilizar los recursos según sea necesario. Al hacerlo, la aplicación debería poder enviar y recibir mensajes SMS automáticamente incluso cuando no sea la aplicación activa en primer plano. Este ajuste garantiza que el proceso en segundo plano necesario pueda funcionar sin interrupciones, evitando las funciones de optimización de la batería que, de lo contrario, podrían impedir su ejecución adecuada.

Preguntas frecuentes para desarrolladores

¿Cómo generar una clave API?

Descripción de muestra de acordeónPara generar una clave API, descargue nuestra aplicación en su teléfono móvil y cree una cuenta sin costo. Se generará automáticamente una clave API y se vinculará a su teléfono móvil. También recibirá un correo electrónico con toda la información necesaria. Este proceso garantiza que pueda comenzar a utilizar nuestros servicios de manera rápida y sencilla con una configuración mínima.

¿Dónde puedo encontrar siempre mi clave API?

En su aplicación móvil, navegue hasta el menú AJUSTES o AYUDA, donde su clave API estará visible en todo momento. Esto garantiza que pueda acceder fácilmente a su clave API siempre que la necesite para integrar o usar nuestros servicios.

¿Puede la creación de una clave API ser anónima?

Sí, no requerimos ninguna prueba de identidad para crear una clave API. Por lo tanto, la comunicación entre nuestra API y su teléfono móvil es totalmente anónima. Este enfoque permite a los usuarios mantener su privacidad mientras utilizan nuestros servicios.

¡Empiece a utilizar SMSmobileAPI hoy mismo!

Experimente la libertad y flexibilidad de administrar sus servicios de SMS desde cualquier lugar. Descargue nuestra aplicación móvil ahora y dé el primer paso hacia una integración perfecta de SMS.

Descargar la aplicación