Você está na página 1de 9
Conteúdo Introdução 2 Início e comandos básicos 2 Exemplo método GET 3 Exemplo método POST

Conteúdo

Introdução

2

Início e comandos básicos

2

Exemplo método GET

3

Exemplo método POST

3

Códigos de retorno

4

Exemplo para envio em Cold Fusion

4

Exemplo para envio em PHP

5

Exemplo para envio em ASP

8

Especificação HTTP v1.1

Introdução Este é um manual que atende as especificações necessárias para o envio de uma

Introdução

Este é um manual que atende as especificações necessárias para o envio de uma mensagem por vez, a cada chamada HTTP para os servidores da FastSMS, via GET ou POST utilizando a porta padrão de comunicação 80. Você pode utilizar também o HTTPS que está diponível em nossa porta 443 assim seus parâmetros serão enviados de forma criptografada. Você pode acessar nossos servidores no endereço: http://www.fastsms.com.br ou https://www.fastsms.com.br. Os parâmetros enviados não tem diferença quanto maiúsculo ou minúsculo

Início e comandos básicos

Para começar, registre-se na FastSMS. Você receberá um ID em “Meu ID”. Esse ID e juntamente com a sua senha definirão todas as chamadas a serem feitas nos servidores da FastSMS.

A estrutura de chamada basicamente resume-se a linha abaixo (esse link deve ser colado inteiro em um browser para realizar a chamada corretamente):

Na URL acima, você deverá trocar:

- MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro

- MinhaSenha: Troque pela senha que você informou em seu cadastro

- ZZXXXXXXXX: Coloque aqui o número que deseja enviar a mensagem. O formato

para o número de destino é: os dois primeiros algarismos são destinados para o código de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a

mensagem.

- Meu+texto+vai+aqui: Digite aqui o texto da sua mensagem.

Esta foi a descrição do método GET, o mais fácil de utilizar.

Você também pode checar a quantidade disponível para envio de SMS (seu saldo) utilizando a URL:

Especificação HTTP v1.1

É possível também ser notificado quanto o status da sua mensagem. Assim que obtivermos o

É possível também ser notificado quanto o status da sua mensagem. Assim que obtivermos o retorno da entrega da operadora faremos uma chamada em seu servidor informando os seguintes parâmetros:

O retorno será seu ID identificando sua conta, o número da mensagem que foi gerado anteriormente e seu status. Se quiser adicionar a possibilidade de receber em tempo real o status da sua mensagem, entre em contato com suporte@fastsms.com.br fornecendo sua URL para o retorno.

Exemplo método GET

Um exemplo da URL de chamada seria:

Exemplo método POST

Também é possível o envio da mensagem via POST (HTML). Se for mais conveniente, pode-se utilizar um formulário com os dados a serem enviados conforme o exemplo abaixo:

<form action=”http://www.fastsms.com.br/sms.cfm” method=”POST”>

<input type=”hidden” name=”id” value=”MeuID”>

<input type=”hidden” name=”senha” value=”MinhaSenha”>

<input type=”hidden” name=”para” value=” ZZXXXXXXXX”>

<input type=”hidden” name=”texto” value=”Meu texto a enviar vai aqui”>

</form>

No formulário HTML acima, você deverá trocar:

- MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro

- MinhaSenha: Troque pela senha que você informou em seu cadastro

Especificação HTTP v1.1

- ZZXXXXXXXX : Coloque aqui o número que deseja enviar a mensagem. O formato para

- ZZXXXXXXXX: Coloque aqui o número que deseja enviar a mensagem. O formato

para o número de destino é: os dois primeiros algarismos são destinados para o código

de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a mensagem.

- Meu texto a enviar vai aqui: Digite aqui o texto da sua mensagem.

Códigos de retorno

Tanto para o método POST como o GET será exibida uma página de retorno. Logo depois da chamada, os servidores da FastSMS retornará com um ID de chamda. Esse ID representa o envio com sucesso ou não.

As respostas serão:

OK: 9b502dec5e6f98ab1891f55f6f74fd23

ou

ERR: Número do erro, descrição do erro

Em caso de sucesso do envio, a página retornará um ID no formato de exemplo:

“9b502dec5e6f98ab1891f55f6f74fd23”

Exemplo para envio em Cold Fusion

Para integração a linguagem de programação Adobe Cold Fusion, segue um exemplo:

<cfhttp method="Get" url="http://www.fastsms.com.br/sms.cfm?id=MeuID&senha=MinhaSenha&para=ZZX XXXXXXX&texto=Meu+texto+vai+aqui"></cfhttp>

<cfoutput>#CFHTTP.FileContent#</cfoutput>

Na tag <cfhttp> acima, você deverá trocar:

- MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro

- MinhaSenha: Troque pela senha que você informou em seu cadastro

Especificação HTTP v1.1

- ZZXXXXXXXX : Coloque aqui o número que deseja enviar a mensagem. O formato para

- ZZXXXXXXXX: Coloque aqui o número que deseja enviar a mensagem. O formato

para o número de destino é: os dois primeiros algarismos são destinados para o código

de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a mensagem.

- Meu+texto+vai+aqui: Digite aqui o texto da sua mensagem.

Exemplo para envio em PHP

Para integração com PHP disponibilizamos uma classe para acesso. Esse código está disponível para download na sua área restrita. Para isso, siga o exemplo abaixo. Serão necessários criar três arquivos, um com um HTML simples somente para simular a chamada do envio, uma para receber esses parâmetros e inicializar a classe de envio e a última com a classe.

Então, crie um arquivo chamado inicio.htm onde deverá conter as seguintes instruções:

<html> <body> <form action="destino.php" method="post"> Número: <input type="text" name="para"><br> Mensagem: <input type="text" name="mensagem"><br> <input type="submit" value="Send SMS"> </form> </body> </html>

Especificação HTTP v1.1

Agora, crie um arquivo chamado destino.php que deverá conter as seguintes informações: <html>

Agora, crie um arquivo chamado destino.php que deverá conter as seguintes informações:

<html>

<body>

<?php

// include FastSMS class include("FastSMS.php"); // criando objeto $sms = new FastSMS; // setando parametros parameters

$sms->SetID("XPT123456");

$sms->SetSenha("suasenha");

$sms->SetTipo("SMS");

//parâmteros do formulário:

$para = $_REQUEST['para'] ; $mensagem = $_REQUEST['mensagem'] ; $sms->SetNumero($para); $sms->SetMensagem($mensagem);

// enviando e pegando resultado $smsresult = $sms->Send(); print $smsresult; ?>

</body>

</html>

No arquivo destino.php, troque as seguintes informações pelas suas:

- MeuID: Troque pelo Seu ID que você recebeu quando realizou seu cadastro

- MinhaSenha: Troque pela senha que você informou em seu cadastro

Agora crie o arquivo FastSMS.php , que é o nome da classe que deverá ser instanciada. Essa classe não precisa ser alterada. Ela deverá conter as seguintes informações:

Especificação HTTP v1.1

<?php class FastSMS { var $user = ""; var $pass = ""; var $number = ""; var $ownnum = ""; var $message = ""; var $messageId = ""; var $type = "";

function SetID($newuser) { $this->user = $newuser; return;

}

function SetSenha($newpass) {

$this->pass = $newpass; return;

}

function SetNumero($newnumber) {

$this->number = $newnumber; return;

}

function SetTipo($newtype) { $this->type = $newtype; return;

}

function SetMensagem($newmessage) { $this->message = $newmessage; return;

}

function SetMensagemId($newmessageid) { $this->messageId = $newmessageid;

}

function MIMEEncode($s) { return base64_encode($s);

}

function Send() { $Body = ""; $Body .= "para=" . $this->number; $Body .= "&ID=" . urlencode($this->user); $Body .= "&senha=" . urlencode($this->pass); $Body .= "&texto=" . urlencode($this->message); if ($this->type != "") $Body .= "&chr_unicode=" . $this->type; $ContentLength = strlen($Body); $Host = "www.fastsms.com.br";

$Header = "POST /sms.cfm HTTP/1.0\n"."Host: $Host\n"."Content-Type: application/x- www-form-urlencoded\n"."Content-Length: $ContentLength\n\n"."$Body\n"; echo("$Header\n"); $socket = fsockopen($Host, 80, $errno, $errstr); if (!$socket) { return ("no_connection");

}

continua na próxima página

Especificação HTTP v1.1

fputs($socket, $Header); $SocRet = ""; while (!feof($socket)) { $SocRet .= fgets($socket, 128); } print

fputs($socket, $Header); $SocRet = ""; while (!feof($socket)) { $SocRet .= fgets($socket, 128);

}

print $SocRet; fclose($socket); $pos = strpos($SocRet, "\n\r"); $SocRet = trim(substr($SocRet, $pos+2));

return $SocRet;

}

function GetID() { return $this->user;

}

function GetSenha() { return $this->pass;

}

function GetNumero() { return $this->number;

}

function GetMensagem() {

Pronto, coloque esses dois arquivos no mesmo diretório e execute. Você deverá conseguir realizar uma chamada PHP em nossos servidores e aguardar a resposta de confirmação do pedido. Você poderá utilizar a página destino.php para acessar seu banco de dados e realizar o envio a partir do mesmo por exemplo.

Exemplo para envio em ASP

Para integração a linguagem ASP, crie um documento com a extensão .asp e coloque o código abaixo, fazendo as trocas necessárias como usuário, senha, telefone e texto:

<% Dim objXmlHttp Dim strHTML Set objXmlHttp = CreateObject("Msxml2.ServerXMLHTTP") objXmlHttp.setTimeouts 1000,1000,1000,1000 objXmlHttp.open "GET",

"http://www.fastsms.com.br/sms.cfm?id=XPTO990000&senha=SuaSenha&para=1191234

567&texto=Teste via ASP", False objXmlHttp.send

strHTML = objXmlHttp.responseText strStatus = objXmlHttp.status

Set objXmlHttp = Nothing

%>

Status: <%=strStatus%><br> Retorno: <%=strHTML%>

Especificação HTTP v1.1

No texto acima, efetue as trocas de: - XPTO990000 : Troque pelo Seu ID que

No texto acima, efetue as trocas de:

- XPTO990000: Troque pelo Seu ID que você recebeu quando realizou seu cadastro

- SuaSenha: Troque pela senha que você informou em seu cadastro

- 1191234567: Coloque aqui o número que deseja enviar a mensagem. O formato para

o número de destino é: os dois primeiros algarismos são destinados para o código de área (DDD) e os oito algarismos restantes é o número do telefone móvel a receber a

mensagem.

- Teste via ASP: Digite aqui o texto da sua mensagem.

Nosso canal de suporte: suporte@fastsms.com.br

Especificação HTTP v1.1