Passar para o conteúdo principal

Como criar Usuarios de API

Atualizado há mais de 2 meses

Os Usuários de API permitem que sistemas externos integrem com sua loja de forma segura através de webservices. Cada usuário possui um token único e permissões específicas para acessar apenas os métodos autorizados.

Passo 1: Acessar o Gerenciamento de Usuários API

Navegação

  1. Acesse o painel administrativo da sua loja

  2. No menu lateral, clique em Configurações

  3. Selecione Webservice

  4. Clique em Usuários API

Passo 2: Cadastrar Novo Usuário API

2.1 Iniciar Cadastro

Na tela de listagem, clique no botão "Cadastrar" no canto superior direito.

2.2 Preencher Informações Básicas

Campo

Descrição

Nome

Identificação do usuário (ex: "ERP Totvs", "App Mobile")

Email

Email do responsável por esta integração

Status

Ativo/Inativo - permite ativar ou desativar temporariamente

Metodos de webservice

Selecione apenas os métodos que o parceiro/sistema precisará acessar. Quanto menos permissões, mais seguro. Ex.: getProdutos

💡 Dica: Use nomes descritivos como "Integração ERP - Estoque" ao invés de "API 1" para facilitar o gerenciamento.

2.3 Selecionar Permissões

3.1 Acessar o Usuário Criado

Após salvar, você será redirecionado para a lista de usuários. Clique no usuário recém-criado para editá-lo.

3.2 Copiar o Token

⚠️ Importante: Guarde este token de forma segura. Ele funciona como uma senha e não deve ser exposto publicamente.

Na tela de edição, localize o campo "Token de Webservice" e clique no ícone de copiar.

📋 Exemplo de Token:

a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6

Passo 4: Utilizar o Token

4.1 Formato da Requisição

As requisições devem ser enviadas via POST no formato JSON ou XML.

Endpoint Base:

https://suaoja.integration.moovin.com.br/webservices/{metodo}

Headers Obrigatórios:

Content-Type: application/json 
token: SEU_TOKEN_AQUI

4.2 Exemplo de Requisição (cURL)

bash

curl -X POST https://suaoja.integration.moovin.com.br/webservices/getProdutos \
-H "Content-Type: application/json" \
-H "token: a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0u1v2w3x4y5z6" \
-d '{
"filtros": {
"status": "1",
"limite": 10
}
}'


Se encontrar qualquer dificuldade ou tiver perguntas, estamos aqui para ajudar! Clique aqui para acessar nosso canal de suporte.

Nossas equipes estão prontas para atendê-lo através dos diversos canais de atendimento disponíveis.

Seu feedback é extremamente importante para nós!

Por gentileza, tire um momento para avaliar a documentação que acabou de ler. Suas opiniões são cruciais para aprimorarmos nossa plataforma e proporcionar a melhor experiência possível.

Respondeu à sua pergunta?