Neste artigo, explicaremos como funciona a autenticação no sistema do Ideris.
A autenticação é essencial para conectar e gerenciar contas de marketplaces no painel Ideris.
Endpoint de Autenticação
- Método: POST
- URL:
https://novo.ideris.com.br/autenticacao
Objetivo:
Permitir a inclusão de uma nova conta de marketplace diretamente pela página de autenticação do Ideris.
Como Funciona
A ação de inclusão ou alteração de autenticação NÃO é realizada diretamente via API. Em vez disso, acontece através da interface do painel Ideris.
Para incluir uma nova conta de marketplace, siga o passo a passo abaixo.
Passo a Passo para Autenticação
-
Acesse sua conta no Ideris:
Certifique-se de estar logado em uma conta do tipo V3 no painel Ideris.
-
Adicione uma nova conta:
- Clique no botão "Adicionar" no painel de autenticação.
- Escolha o marketplace que deseja conectar.
-
Preencha as informações de autenticação:
Cada marketplace pode exigir informações específicas, como:
- Nome da conta.
- Seller ID.
- Token de acesso.
- Configurações da conta.
- Usuário e CNPJ.
-
Finalize a inclusão:
- Clique em "Adicionar Autenticação".
-
Redirecionamento para o marketplace:
- Você será levado à página do marketplace.
- Insira suas credenciais (usuário e senha) para concluir a autenticação.
-
Confirmação no painel Ideris:
- Após a autenticação ser validada pelo marketplace, você será redirecionado novamente ao painel Ideris.
- A URL exibirá informações como:
- Nome do marketplace.
- code (código de autenticação).
- partner_id (em casos onde o marketplace retorna essa informação).
Observações
- Nem todos os marketplaces retornam o partner_id.
- Certifique-se de preencher todas as informações corretamente para evitar erros durante o processo.
Aqui está a versão mais didática e detalhada:
Gerenciamento de Autenticação no Ideris
A autenticação no Ideris não apenas conecta marketplaces ao painel, mas também grava as informações no banco de dados. Além disso, os dados de autenticação são enviados ao solicitante por meio de WebHook.
Consultar Autenticações Ativas
URL do Endpoint:
https://apiv3.ideris.com.br/settings/marketplace/{id}
Método: GET
Objetivo:
- Obter uma lista das autenticações ativas em um painel específico da plataforma Ideris.
Como Fazer a Requisição:
- Inclua no Header:
- Content-Type: application/json.
- Token de autenticação (gerado pela ação Login).
- Opcionalmente, adicione parâmetros de filtro na URL para refinar os resultados.
Atenção ao Limite de Requisições:
- O limite é de 50 chamadas por minuto.
Alterar Autenticação
URL do Endpoint:
https://novo.ideris.com.br/autenticacao
Método: PUT
Objetivo:
- Atualizar os dados de autenticação de uma conta existente no painel Ideris.
Passo a Passo para Alterar Autenticação
-
Processo:
A atualização segue o mesmo fluxo do método POST de autenticação:
- Realize o login no painel.
- Acesse a página de autenticação.
- Preencha ou ajuste as informações da conta.
-
Ações Adicionais Disponíveis:
- Obter informações detalhadas da conta.
- Testar a autenticação.
- Inativar uma autenticação existente.
-
Como Acessar:
- Na lista de autenticações, clique nos três pontos ao lado da conta que deseja gerenciar.
- Selecione a opção desejada:
- Editar: para atualizar as informações.
- Testar autenticação: para verificar a validade.
- Inativar: para desativar a conta.
Aqui está a versão mais didática incluindo a observação:
Observação Importante
- Além de salvar as informações de autenticação no banco de dados do Ideris, os dados de autenticação também serão enviados ao solicitante por meio de WebHook.
Documentação Eletrônica
A documentação completa da API está disponível em um ambiente eletrônico no endereço Swagger.
- Acesso: Não é necessário token para consultar essa documentação.
- Objetivo: Retornar exemplos de objetos padrão, permitindo que você teste as integrações sem precisar de credenciais de acesso.
Se precisar de mais ajuda com este processo, nossa equipe de suporte está pronta para atender você. É só clicar no ícone do whatsapp no canto inferior direito de qualquer página do seu painel Ideris ou abrir um ticket.
Conte sempre conosco. Até a próxima!