Chaves de autenticação

A API de Integração do NDD Space utiliza o protocolo de autenticação OAuth 2.0, que permite a aplicativos como Web App, Mobile e Desktop obterem acesso limitado às informações através do protocolo HTTP.

Para a utilização desta API se faz necessário a obtenção de Client_Id: responsável por identificar o cliente que está emitindo eSecret_Id: uma senha única de acesso à API.

Para isso,

Acesse o portal NDD Space.
Clique na aba Configurações e depois, na opção Integração.
Dentro de Integração, clique em + Criar.

IMPORTANTE

É necessário possuir um usuário com perfil de Administrador do Sistema ou com permissões para acessar o menu Integração.

Após criar uma integração, preencha o campo Nome para dar uma identificação ao processo de integração.
Clique em Salvar e Abrir.
O sistema exibe a mensagem que a criação do ClientID foi realizada com sucesso. É possível visualizar o código único, para uso deste requisito nas chamadas da API.
Para vincular as empresas que fazem parte dessa configuração de Integração, clique na aba Empresa, e depois clique em Adicionar.
O sistema abre uma tela que exibe todas as empresas cadastradas no portal.
Selecione a que deseja adicionar e clique em Definir. O sistema exibe mensagem informando que o cadastro foi concluído com sucesso.
Volte para a aba Dados Gerais e clique em Gerar Client Secret.

IMPORTANTE

O sistema exibe a seguinte mensagem para confirmar a geração do Client Secret:

Confirmação para gerar Client Secret

ATENÇÃO! Ao gerar um Client Secret novo, a sua API de integração poderá parar de funcionar até que seu Client Secret atual seja substituído pelo novo que está sendo criado

Caso já tenha criado o Client Secret, clique em Visualizar Client Secret para obter o código único para uso nas chamadas.
Após realizados os passos acima, os pré-requisitos de segurança e autenticação para uso da API foram concluídos.

IMPORTANTE

Para que documentos sejam transacionados pela API, a empresa deve estar habilitada dentro de uma Licença.