User Tools

Site Tools


br-060-check-user


Verificando usuários

Quando um usuário assina um canal, o Followzup cria um código aleatório de 8 (oito) dígitos numéricos conhecido como Código da Assinatura (Subscription Code), que fica associado a essa assinatura.

Caso o usuário cancele a assinatura e em seguida faça a assinatura do canal novamente, um novo código é gerado, e pode ser visto na tela do APP quando o usuário visualiza a lista de mensagens do canal.

O Código da Assinatura é particularmente útil para que o desenvolvedor da aplicação valide a identificação do usuário, confirmando assim o e-mail (ou User-ID).



Chamada da API para verificar usuários

Para verificar se a assinatura do usuário corresponde ao Código da Assinatura, a aplicação deve usar o método submit contido na API, com seguintes parâmetros:

FZUP_COMMAND Obrigatório Deve conter a literal chck (check user).
FZUP_LASTSEQ Opcional Contém o número de sequência da última solicitação.
FZUP_USER Obrigatório Contém o e-mail ou o User-ID do usuário a ser verificado.
FZUP_SUBSCODE Obrigatório Contém o Código da Assinatura a ser verificado.



Exemplos:

PHP
$result = $object -> submit ( array (
"FZUP_COMMAND  = chck",
"FZUP_LASTSEQ  = 9999",
"FZUP_USER     = user.email@anymail.com",
"FZUP_SUBSCODE = 12345678" ) );
JAVA
String[] result = object.submit ( new String[] {
"FZUP_COMMAND  = chck",
"FZUP_LASTSEQ  = 9999",
"FZUP_USER     = zw2hg454ghx9",
"FZUP_SUBSCODE = 12345678" } );
RUBY
result = object.submit (
"FZUP_COMMAND"  => "chck",
"FZUP_LASTSEQ"  => "9999",
"FZUP_USER"     => "user.email@anymail.com",
"FZUP_SUBSCODE" => "12345678" )
PERL
my $result = $object->submit (
"FZUP_COMMAND  = chck",
"FZUP_LASTSEQ  = 9999",
"FZUP_USER     = z74gd672kmv6",
"FZUP_SUBSCODE = 12345678" );
PYTHON
result = object.submit([
"FZUP_COMMAND  = chck",
"FZUP_LASTSEQ  = 9999",
"FZUP_USER     = z74gd672kmv6",
"FZUP_SUBSCODE = 12345678"])



Retorno da execução

Nos exemplos anteriores, podemos verificar que a execução do método submit retorna um array de strings denominado result. Esse array possui 3 elementos:

Código de retorno Código de retorno da solicitação, sendo o valor “0” (zero) para as solicitações executadas com sucesso e o valor “NNNN” contendo o código de erro da execução.
Número de sequência Valor inteiro contendo o número de sequência utilizado na solicitação.
XML de resposta da solicitação String contendo o XML de resposta da solicitação.

Com exceção do código de retorno 6101, tratado pela API, os demais erros devem ser tratados pela aplicação.

É importante que o número de sequência utilizado na última solicitação seja armazenado na base de dados da aplicação, para o caso do objeto instanciado ter sido descartado pelo ambiente. Dessa forma, a última sequência poderá ser informada para a API na próxima solicitação e evitar que a API receba códigos de erro 6101, forçando o reenvio de solicitações e aumentando o tempo de resposta das solicitações.



Códigos de retorno

0 Execução com sucesso O Código da Assinatura está correto e o usuário é assinante do canal.
6101 Sequência inválida Esse código de retorno é tratado pela API
6102 Frame inválido Informa que houve erro na decriptação dos dados, podendo ter ocorrido falha na transmissão
6103 Comando inválido Comando inválido ou não foi informado
6104 Channel-ID inválido Channel-ID inválido ou não foi informado
6106 Usuário inválido Usuário inválido ou não foi informado
6203 Usuário não é assinante Usuário informado não é assinante do canal
6204 Código da Assinatura não confere O valor informado não confere com a assinatura do canal.
6999 Sistema em manutenção Webservice encontra-se em manutenção



Formato do XML de resposta da solicitação

<?xml version="1.0" encoding="utf-8"?>
<followzup>
  <uid>User-ID</uid>
  <reg>yes|no</reg>
</followzup>

Onde:
 - User-ID:  Identificação do usuário no Followzup.
 - Register: Flag usuário registrado (yes) ou anônimo (no).  


br-060-check-user.txt · Last modified: 2017/04/20 16:16 by admin

Page Tools