Conteúdo. Especificação HTTP v1.1

Transcrição

1 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

2 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: ou 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): XXX&texto=Meu+texto+vai+aqui 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: É 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:

3 daa41c10f&status=enviado 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: to=isso+é+um+teste 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= method= POST > </form> <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 > 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 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.

4 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: ou OK: 9b502dec5e6f98ab1891f55f6f74fd23 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=" 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 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.

5 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>

6 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:

7 <?php class FastSMS { var $user = ""; var $pass = ""; var $number = ""; var $ownnum = ""; var $message = ""; var $messageid = ""; var $type = ""; function SetID($newuser) { $this->user = $newuser; function SetSenha($newpass) { $this->pass = $newpass; function SetNumero($newnumber) { $this->number = $newnumber; function SetTipo($newtype) { $this->type = $newtype; function SetMensagem($newmessage) { $this->message = $newmessage; 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 = " $Header = "POST /sms.cfm HTTP/1.0\n"."Host: $Host\n"."Content-Type: application/xwww-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...

8 ?> 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() { return $this->message; function GetTipo() { return $this->type; 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:

9 <% Dim objxmlhttp Dim strhtml Set objxmlhttp = CreateObject("Msxml2.ServerXMLHTTP") objxmlhttp.settimeouts 1000,1000,1000,1000 objxmlhttp.open "GET", " 567&texto=Teste via ASP", False objxmlhttp.send strhtml = objxmlhttp.responsetext strstatus = objxmlhttp.status Set objxmlhttp = Nothing %> Status: <%=strstatus%><br> Retorno: <%=strhtml%> 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 : 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