Dev DOC - SMSMobileAPI

SMSmobileAPI Developer Documentation

Na SMSmobileAPI, nos esforçamos para tornar nossa API o mais compatível possível com qualquer arquitetura ou plataforma.
Quer você esteja usando REST, SOAP, cURL ou várias linguagens de programação como Python, JavaScript, PHP e mais, nossa API foi projetada para se integrar perfeitamente aos seus projetos.

Também temos plugins prontos para uso para soluções e software de comércio eletrônico. Clique aqui para descobri-los.

Se você tiver alguma dúvida, sugestão ou precisar de ajuda, nossa equipe está aqui para ajudar.
Sinta-se à vontade para entrar em contato conosco em api@smsmobileapi.com

API REST

cURL

JavaScript

Pitão

Node.js

Rubi

WSDL

API de envio de SMS

Este endpoint da API permite o envio de SMS por meio de uma solicitação HTTP do smartphone.

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

Parâmetros:

- recipients: O número do celular do destinatário.

- mensagem: A mensagem a ser enviada.

- apikey: A chave API que você possui ou receberá.

Observação:

Devido a obrigações relacionadas ao uso do telefone e às políticas do Android, somos obrigados a aumentar o atraso entre o envio de duas mensagens SMS se o aplicativo estiver sendo executado em segundo plano ou fechado. As mensagens SMS ainda podem ser enviadas mesmo quando o aplicativo móvel estiver fechado, mas isso resultará em um atraso maior no despacho.

Obtenha a API SMS

Este endpoint da API é usado para recuperar mensagens SMS recebidas no smartphone.

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

Parâmetro:

- apikey: a chave da API.

Enviar SMS

URL do WSDL

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

Parâmetros:

- recipients: O número do celular do destinatário.

- mensagem: A mensagem a ser enviada.

- apikey: A chave API que você possui ou receberá.

Exemplo

 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 cURL

Você pode usar o seguinte comando cURL para enviar um SMS via SMSmobileAPI:

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

Exemplo cURL em PHP

Se você estiver usando PHP, veja como enviar um 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 exemplo PHP demonstra como enviar uma solicitação POST usando cURL para o SMSmobileAPI, passando os parâmetros necessários como uma matriz associativa.

Enviar SMS

Use nosso módulo Python oficial: https://smsmobileapi.com/python/
ou use o método manual...

Usando a biblioteca `requests`

A biblioteca `requests` é uma biblioteca HTTP popular e simples para Python. Veja como você pode usá-la para enviar um 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)

Este exemplo demonstra uma solicitação POST simples para o SMSmobileAPI, enviando uma mensagem para um número de telefone específico.

Usando a biblioteca `http.client`

A biblioteca `http.client` está incluída na biblioteca padrão do Python e também pode ser usada para interagir com sua 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 exemplo mostra como usar a biblioteca `http.client` para enviar uma solicitação POST para a API. Os parâmetros são codificados em URL e enviados com os cabeçalhos apropriados.

Enviar SMS

Usando a API `fetch`

A API `fetch` é uma maneira moderna e versátil de fazer solicitações HTTP em JavaScript. Veja como você pode usá-la para enviar um SMS via 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 exemplo demonstra como enviar uma solicitação POST usando a API `fetch`, que é suportada na maioria dos navegadores modernos.

Usando `XMLHttpRequest`

Se precisar de suporte a navegadores mais antigos, você pode usar o 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 exemplo mostra como usar `XMLHttpRequest` para enviar uma solicitação POST, fornecendo compatibilidade com navegadores mais antigos que podem não suportar `fetch`.

Enviar SMS

Usando a biblioteca `axios`

A biblioteca `axios` é um cliente HTTP popular para Node.js. Veja como você pode usá-la para enviar um 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);
 });

Este exemplo demonstra como enviar uma solicitação POST usando `axios` no Node.js para interagir com o SMSmobileAPI.

Enviar SMS

Usando a biblioteca `Net::HTTP`

Você pode usar a biblioteca `Net::HTTP` em Ruby para enviar um 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

Este exemplo demonstra como enviar uma solicitação POST usando `Net::HTTP` em Ruby para o SMSmobileAPI.

Clique aqui para testar a chave API e o serviço com o formulário simples

Dependendo da versão do Android instalada no celular, o sistema operacional pode dificultar o bom funcionamento do envio e recebimento automático de mensagens SMS quando o aplicativo SmsMobileApi não estiver em primeiro plano.
Esse problema surge de um processo que tenta ser executado em segundo plano quando o aplicativo não é iniciado ativamente. No entanto, devido às medidas de otimização da bateria do Android, que variam entre as diferentes versões, esse processo em segundo plano pode não ser iniciado corretamente. A otimização da bateria do Android foi projetada para limitar a atividade em segundo plano dos aplicativos para conservar a vida útil da bateria, o que pode afetar inadvertidamente aplicativos que exigem processos em segundo plano para funcionar corretamente.

Para resolver esse problema, os usuários podem definir manualmente as configurações do Android para permitir que o SmsMobileApi use recursos sem restrições.
Isso envolve ajustar as configurações de otimização da bateria para o aplicativo específico, essencialmente instruindo o Android que o SmsMobileApi tem permissão para ser executado em segundo plano e usar recursos conforme necessário. Ao fazer isso, o aplicativo deverá ser capaz de enviar e receber mensagens SMS automaticamente, mesmo quando não for o aplicativo ativo em primeiro plano. Este ajuste garante que o processo em segundo plano necessário possa operar ininterruptamente, contornando os recursos de otimização da bateria que poderiam impedir sua execução adequada.

Perguntas frequentes para desenvolvedor

Como gerar uma chave de API?

Exemplo de descrição do acordeãoPara gerar uma chave API, baixe nosso aplicativo em seu celular e crie uma conta sem nenhum custo. Uma chave API será gerada automaticamente e vinculada ao seu celular. Você também receberá um e-mail com todas as informações necessárias. Esse processo garante que você possa começar a usar nossos serviços de maneira rápida e fácil, com configuração mínima.

Onde posso sempre encontrar minha chave de API?

Em seu aplicativo móvel, navegue até o menu CONFIGURAÇÕES ou AJUDA, onde sua chave API fica visível o tempo todo. Isso garante que você possa acessar facilmente sua chave API sempre que precisar para integrar ou usar nossos serviços.

A criação de uma chave de API pode ser anônima?

Sim, não exigimos nenhuma prova de identidade para criar uma chave API. A comunicação entre a nossa API e o seu telemóvel é, portanto, 100% anónima. Essa abordagem permite que os usuários mantenham sua privacidade enquanto utilizam nossos serviços.

Comece hoje mesmo com SMSmobileAPI!

Experimente a liberdade e a flexibilidade de gerenciar seus serviços de SMS em qualquer lugar. Baixe nosso aplicativo móvel agora e dê o primeiro passo para uma integração perfeita de SMS.

Baixe o aplicativo