Cadastro - Varejonline/api GitHub Wiki

Integrando seu aplicativo com o Varejonline

Existem duas formas de obter um token de autenticação para consumir os Endpoints Varejonline:

1. Token direto via Suporte Varejonline

  1. Solicite ao Suporte Varejonline a geração de um token de acesso (O contato está ao fim da página).
  2. Utilize este token diretamente em suas chamadas à API.

Características:

  • O token fornecido pelo suporte é não expirável.
  • O token é genérico e não identifica qual usuário realizou a autenticação.
  • Recomendado para integrações mais simples, quando não há necessidade de vinculação a usuários específicos.

2. Integração via OAuth 2.0

  1. Crie sua conta no DevCenter e cadastre seu aplicativo.
  2. Integre seu aplicativo via OAuth 2.0.
  3. Obtenha o authorization code e troque-o pelo access token.

Características:

  • O token obtido via OAuth 2.0 permite identificar qual usuário realizou a autenticação.
  • Recomendado quando é necessário controle de permissões ou rastreabilidade de usuários.
  • Processo de integração mais detalhado, exigindo cadastro de aplicativo e implementação do fluxo de autorização.

Exemplo de utilização do token

Independentemente do método de obtenção do token (OAuth 2.0 ou suporte), sua utilização nas chamadas à API segue o mesmo padrão.

  • O token deve ser enviado junto à requisição para autenticação.
  • Atualmente, a API do Varejonline suporta o envio do token como parâmetro de URL (query string), conforme exemplos abaixo:
GET de Entidades http://integrador.varejonline.com.br/apps/api/entidades?token=TOKEN_RECEBIDO
GET de Produtos  http://integrador.varejonline.com.br/apps/api/produtos?token=TOKEN_RECEBIDO

Considerações

  • Utilize OAuth 2.0 quando houver necessidade de autenticação individualizada e controle por usuário.
  • Utilize o token fornecido pelo suporte quando o objetivo for apenas simplificar a autenticação sem preocupação com expiração ou identificação de usuários.