Integrar tu aplicación con la plataforma de SMSpubli te permitirá comunicarte vía SMS de una forma sencilla y totalmente automatizada. Al igual que con cualquier otro tipo de comunicación, para poder enviar mensajes de texto utilizando cURL a través de nuestra API SMS, necesitas tu clave de API. La puedes encontrar en la sección API del menú principal de la plataforma. Si aún no tienes cuenta, regístrate con nosotros.
Enviar mensajes de texto con cURL
Para que podamos procesar la petición que hagas a nuestro servidor con cURL, ésta debe estar construida en formato JSON como en el ejemplo a continuación:
'{
"api_key":"API_KEY",
"messages":[
{
"from":"REMITENTE",
"to":"346XXXXXXXX",
"text":"Texto del mensaje a enviar"
}
]
}'
En el ejemplo anterior tienes que sustituir los siguientes valores:
- API_KEY: Tu clave de API.
- from: El remitente que se mostrará en el SMS.
- to: El destinatario del SMS.
- text: El texto del SMS.
Para un uso más eficiente, puedes mandar hasta 1000 SMS con una sola petición del siguiente modo:
'{
"api_key":"API_KEY",
"messages":[
{
"from":"REMITENTE",
"to":"346XXXXXXXX",
"text":"Texto del mensaje a enviar"
},
{
"from":"REMITENTE",
"to":"346XXXXXXXX",
"text":"Texto del mensaje a enviar 2"
}
.
.
.
]
}'
Ejemplo de petición al servidor
Debemos efectuar la petición por el método POST, que es el único que acepta nuestra API y, puesto que el formato del contenido de la petición es JSON, debemos establecer los headers en el citado formato:
'Content-Type: application/json' 'Accept: application/json'
A continuación puedes ver el ejemplo completo de la petición a nuestra API usando Curl:
curl -X POST \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"api_key":"API_KEY",
"messages":[
{
"from":"REMITENTE",
"to":"346XXXXXXXX",
"text":"Texto del mensaje a enviar"
}
]
}' https://api.gateway360.com/api/3.0/sms/send
Una vez hecha esta petición, recibiríamos una respuesta del servidor con el siguiente formato:
{
"status":"ok",
"result":[
{
"status":"ok",
"sms_id":"a485ef96728ae374828e7e92e829e85",
"custom":""
}
]
}
Esta respuesta nos llega en formato JSON y contiene con un campo “status”, donde se indica si se ha podido procesar la petición y un campo “result”, que es un array con una entrada por cada mensaje enviado en “messages”, en el mismo orden que en la petición e informándonos sobre los siguientes detalles de cada uno de los mensajes:
- “status”: indica si hemos podido procesar el mensaje.
- “sms_id”: identificador único asignado al mensaje por nuestro sistema.
- “custom”: valor que se indicó al hacer la petición o en blanco si no se envió ninguno
Para más información, podéis visitar la documentación de nuestra API.
Empieza tu prueba gratuita con 0,60€ de
saldo
Más funcionalidad en tu llamada a la API SMS
En nuestro ejemplo, hemos creado una llamada básica a la API, pudiendo usar otros parámetros con los que disfrutar de las distintas opciones que nos ofrece la API SMS.
Entre ellos, está el parámetro “send_at”, con el que podemos programar nuestros mensajes para que se envíen en una fecha y hora concretas. O el parámetro “fake” con el que podemos simular el envío de mensajes pero sin que se lleguen a mandar en realidad, siendo muy útil durante la fase de pruebas.
Puedes consultar la lista completa de parámetros en la documentación de la API.
Si estás listo para empezar a usar nuestra API, ya puedes crear tu cuenta en SMSpubli. Si tienes alguna duda, nuestro equipo de expertos estará encantado de ayudarte llamando al 911 100 120, enviando un email a [email protected] o a través de nuestro formulario de contacto.
Empieza tu prueba gratuita
con 0,60€ de saldo
