Autenticação

Este artigo explica como autenticar na nossa API.
Todas as integrações descritas nos próximos artigos dependem deste processo.

Visão geral

Protocolo: REST, payloads em JSON
Autenticação: HTTP Basic via cabeçalho Authorization
Credenciais: login/senha de um usuário Webservice criado no seu DMS e importado para a nossa plataforma

Criar o usuário Webservice

No seu DMS, crie um novo usuário dedicado à integração.
O usuário deve estar Ativo.
Não precisa de permissões no DMS.

Na nossa plataforma, importe este usuário.
Abra o cadastro do usuário importado e, em Tipo de Acesso, marque Webservice:

Salve.

Dica: crie usuários separados por fornecedor de software. Assim, cada login terá apenas as permissões necessárias para sua integração.

Permissões na plataforma

Depois de marcar o Tipo de Acesso Webservice, conceda as permissões de usuário compatíveis com a(s) integração(ões) que você pretende usar.
Exemplo: para atualizar acessórios na entrega de um veículo, o usuário deve ter a permissão correspondente; do contrário, a integração será recusada.

Como enviar a autenticação (HTTP Basic)

Monte o cabeçalho Authorization com:
Authorization: Basic <base64(login:senha)>

Concatene login:senha.
Converta a string em UTF-8 para Base64.
Inclua o prefixo Basic seguido de espaço.

Exemplo completo

Login: webservice@movi
Senha: 123456
login:senha → webservice@movi:123456
Base64(UTF-8) → d2Vic2VydmljZUBtb3ZpOjEyMzQ1Ng==

Cabeçalho final:

Authorization: Basic d2Vic2VydmljZUBtb3ZpOjEyMzQ1Ng==

Exemplo de requisição
curl -X GET https://api.sua-plataforma.com.br/v1/
-H “Authorization: Basic d2Vic2VydmljZUBtb3ZpOjEyMzQ1Ng==”
-H “Content-Type: application/json”