¿Cómo probar la API de EnviosSMS?

Antes de comenzar con el artículo, recomendamos que tengas conocimientos básicos en programación o estructuración de peticiones HTTP. De otro modo, te resultará un tanto compleja la información presentada.

Realizar consulta a la API a través de Postman

Una vez instalado y abierto Postman, en la pantalla principal observaremos algo así:

Si eres nuevo, la pantalla puede intimidarte pero no te preocupes, iremos señalando las partes más importantes y las describimos aquí debajo. Luego las detallaremos paso a paso hasta que logres enviar tu SMS.

1. Aquí puedes definir el método HTTP que utilizarás en tu petición. GET, POST, PUT, DELETE son algunos de ellos. Por lo general, nosotros utilizaremos POST.
2. En este campo, colocas la URL hacia la API que vas a consumir. Para nuestro caso será
   https://api.EnviosSMS.com/restapi/sms/1/text/single
3. Las diferentes solapas te permitirán establecer datos importantes y necesarios de la petición, tales como la autorización, los encabezados y el cuerpo de la misma, entre otras.
4. Una vez que hayamos conformado nuestra petición, presionaremos el botón Send para enviarla a la API.

Estableciendo la autorización de la petición (Authorization)

A través de la autorización, podremos autenticar nuestra identidad como usuarios de EnviosSMS y hacer uso de la API de forma libre y segura.

Para configurar dichos datos, debemos dirigirnos a la solapa Authorization. Una vez allí, estableceremos el Type (Tipo) como Basic Auth. Este método lo que hace es tomar nuestras credenciales de acceso, encriptarlas y luego enviarlas a la API.

Por un lado, debemos colocar el Username (Nombre de usuario) de nuestra cuenta de EnviosSMS, también la Password (Contraseña) de la misma. Estos datos son los mismos con los que accede a la Plataforma Web.

Postman se encargará de encriptar estos datos automáticamente, por lo que esta acción no es necesaria realizarla manualmente.

Definiendo los encabezados de la petición (Headers)

Los headers o encabezados nos permiten establecer ciertos parámetros de nuestra petición. Para este tutorial, solo vamos a definir la información que vamos a enviar que es de tipo JSon.

1. Definiendo el "Content-Type" a application/json como se lo muestra en el recuadro de la imagen, podremos decirle a la API de EnviosSMS en qué formato estamos enviando nuestros datos. Es posible cambiar el formato de esta KEY de los Headers, por lo general viene por defecto en text/plain y debería modificarlo.

Generando el cuerpo de la petición (Body)

El body de nuestra petición HTTP nos permite establecer los datos que interceptará la API de EnviosSMS para realizar el envío del SMS

            {
            "from": "MiNumero",
            "to": "+50591122223333",
            "text": "Este es un mensaje de Prueba desde EnviosSMS.com"
            }