Podemos resumir essa tarefa em 3 etapas:
- Realizar autenticação, veja esse artigo
- Enviar a requisição http
- Analisar a resposta
Passo 1
Para autenticar-se e poder utilizar os serviços da API , veja esse artigo que demonstra um passo-a-passo para obter permissão de acesso aos serviços da API. Sem realizar essa etapa com sucesso, não será possível utilizar o serviço.
Passo 2, enviar requisição http
O serviço de envio de mensagens espera uma requisição http com essas informações:
- Formato: POST
- URL: https://www.mviral.com.br/api/dispatch
- Tipo de dados: form-urlencoded (Content-type: x-www-form-urlencoded)
- Parâmetros obrigatórios: text, numbers, type, from
Os parâmetros obrigatórios:
- text: a mensagem sms que deseja enviar
- numbers: os números que devem receber a mensagem, separados pelo caractér ',' (vírgula)
- type: deve ser um desses valores; CORPORATIVO, MARKETING
- from: nome do remetente da mensagem. Esse nome será adicionado ao inicio da mensagem para garantir que a mensagem irá com o nome de um remetente
Importante: se a mensagem exceder 150 caractéres, ela será reduzida para não ultrapassar esse limite.
Por exemplo, utilizando o programa curl para enviar um requisição http POST, uma requisição para a API poderia ser assim:
curl --insecure -i -X POST -H "X-Auth-Token:seu-token-aqui" -d 'numbers=99008894,99767081&text=Sms de teste&type=MARKETING&from&Mobile Mind' https://www.mviral.com.br/api/dispatch
Passo 3
Em caso de sucesso, a API irá responder:HTTP/1.1 200 OK
Date: Wed, 27 Aug 2014 15:35:35 GMT
Server: Apache/2.4.6 (Ubuntu)
Content-Length: 7
Content-Type: text/html;charset=UTF-8
success
HTTP/1.1 400 Bad Request
Date: Wed, 27 Aug 2014 15:37:44 GMT
Server: Apache/2.4.6 (Ubuntu)
Content-Length: 64
Connection: close
Content-Type: text/html;charset=UTF-8
Parameters missing. Make sure to send all of these: numbers,text,type,from
Em caso de dúvidas ou dificuldades, entre em contato através do e-mail suporte@mobilemind.com.br.