Autenticação

Visão Geral

As chaves de API são usadas para autenticar todas as solicitações à API Nomid MDM. Inclua sua chave de API no cabeçalho X-API-Key com cada solicitação.

X-API-Key: nm_acme_a1b2c3d4e5f6...

Obtendo Sua Chave de API

As chaves de API são criadas e gerenciadas através do Portal Nomid. Siga estes passos para criar sua primeira chave de API.

Pré-requisitos

• Uma conta Nomid MDM com acesso de administrador
• Acesso às Configurações da Empresa no Portal Nomid

1. 1

   Acesse o Portal Nomid

   Abra seu navegador e acesse o Portal Nomid. Entre com suas credenciais de administrador.

2. 2

   Navegue até Integrações

   Após fazer login, vá para a seção Configurações da Empresa e selecione a aba Integrações.

3. 3

   Clique em Criar Chave de API

   Clique no botão "Criar Chave de API" localizado no canto superior direito da página de Integrações.

4. 4

   Digite um Nome

   No modal que aparece, digite um nome descritivo para sua chave de API. Isso ajuda a identificar a chave posteriormente (ex.: "Integração Power BI" ou "Sincronização CRM").

5. 5

   Copie Sua Chave

   Após clicar em Criar, sua chave de API será exibida. Clique no botão copiar para copiá-la para a área de transferência. A chave será exibida apenas uma vez!

Formato da Chave de API

As chaves de API seguem este formato:

nm_{company}_{random_32_chars}

• Todas as chaves começam com 'nm_'
• Prefixo específico da empresa para identificação
• 32 caracteres aleatórios para segurança

Usando Sua Chave de API

Inclua a chave de API no cabeçalho X-API-Key com cada solicitação:

curl -X GET "https://api.nomid.tech/emm/api/v1/assets" \
  -H "X-API-Key: nm_acme_a1b2c3d4e5f6..."

Melhores Práticas de Segurança

• Nunca exponha chaves de API em código do lado do cliente ou repositórios públicos
• Rotacione chaves regularmente e revogue chaves não utilizadas
• Armazene chaves em variáveis de ambiente, não no código
• Use as permissões mínimas necessárias para sua integração

Erros de Autenticação

A API retorna códigos de erro específicos para problemas de autenticação: