User Tools

Site Tools


br-131-app-rdev


Solicitação APP / Registro

Solicita o registro de novos dispositivos ao webservice, por meio de POST.

Ao solicitar o registro de um novo dispositivo para o login informado, o Followzup cria o Código do Dispositivo (Device-ID) e um par de chave criptográficas (RSA), associadas ao dispositivo. No caso de registro anônimo, o Followzup cria também um Código de Usuário anônimo (User-ID).

Como o dispositivo ainda não existe, o XML de solicitação é criptografado com a chave pública do APP (Interface-ID), que é utilizada apenas no registro de novos dispositivos.

Uma vez registrado, o APP recebe as informações do novo dispositivo (User-ID, Device-ID e chave pública do dispositivo), que devem ser armazenadas em sua base local. A partir dai, as novas solicitações deverão ser criptografadas com a chave pública do dispositivo.



Variáveis POST

id Código de identificação da Interface (APP), sem criptografia (Interface-ID)
key Chave AES (temporária), criptografada com a chave pública da Interface e codificada em Base64 / URL Encode.
frame String criptografado com a chave AES (temporária), contendo o XML de solicitação codificado em Base64 / URL Encode.



XML de resposta do POST

Após o processamento da solicitação contida no POST, o webservice retorna o seguinte XML para o solicitante:

<?xml version="1.0" encoding="utf-8"?>
<followzup>
<retcode>código-de-retorno</retcode>
<retframe>xml-de-resposta-da-solicitação</retframe>
<retmd5>md5-de-resposta</retmd5>
</followzup>

Onde:

  • código-de-retorno: String não criptografado, contendo o valor “0” (zero) para as solicitações executadas com sucesso, ou o código de erro correspondente, composto por 4 dígitos numéricos.
  • xml-de-resposta-da-solicitação: String criptografado com a mesma chave AES utilizada no envio da solicitação (chave temporária), e codificado em Base64.
  • md5-de-resposta: String contendo o hash md5 do campo acima.



XML de solicitação

<?xml version="1.0" encoding="utf-8"?>
<followzup>
<stp>stamp</stp>
<eml>login</eml>
<pwd>password</pwd>
</followzup>

Onde:

  • stamp: Código STAMP da Interface.
  • login: E-mail do usuário ou literal anonymous para registro de dispositivos anônimos.
  • password: Senha do usuário ou literal anonymous para registro de dispositivos anônimos.



XML de resposta da solicitação

<?xml version="1.0" encoding="utf-8"?>
<followzup>
<uid>USER-ID</uid>
<did>DEVICE-ID</did>
<pub>public-key</pub>
<mod>public-key-module</mod>
<pux>public-key-index</pux>
</followzup>

Onde:

  • USER-ID: Código do usuário registrado;
  • DEVICE-ID: Código do dispositivo registrado;
  • public-key: Chave pública RSA (formato BASE64).
  • public-key-module: Módulo da chave pública RSA (formato BINARY).
  • public-key-index: Índice da chave pública RSA (formato BINARY).


Códigos de Retorno

0 Execução com sucesso
7102 Frame inválido
7104 Interface-ID inválido
7105 Stamp inválido
7107 E-mail inválido
7108 Senha inválida
7999 Webservice em manutenção


br-131-app-rdev.txt · Last modified: 2017/03/08 09:09 by admin

Page Tools