Autenticação de Parceiros

A autenticação de parceiros é o primeiro passo para acessar a API de integração da Nuvende. Cada parceiro possui credenciais específicas (client_id e client_secret) que são utilizadas para obter tokens de acesso temporários.

Visão Geral

O sistema de autenticação de parceiros funciona através de um fluxo OAuth2 simplificado:

1. Credenciais do Parceiro: Cada parceiro possui um client_id e client_secret únicos
2. Token de Acesso: Credenciais são trocadas por um token JWT temporário
3. Autorização: Token é usado para autenticar requisições subsequentes

Endpoint de Login

POST /api/v2/partners/auth/login

Autentica o parceiro e retorna um token de acesso Bearer.

Requisição

curl --location 'https://api-h.nuvende.com.br/api/v2/partners/auth/login' \
--header 'Content-Type: application/json' \
--data '{
  "client_id": "seu_client_id",
  "client_secret": "seu_client_secret"
}'

Parâmetros

Resposta de Sucesso

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "token_type": "bearer",
  "expires_in": 3600
}

Campos da Resposta

Uso do Token

Após obter o token de acesso, utilize-o no cabeçalho Authorization de todas as requisições subsequentes:

curl --location 'https://api-h.nuvende.com.br/api/v2/partners/application' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...'

Segurança

Boas Práticas

• Armazenamento Seguro: Mantenha as credenciais em variáveis de ambiente
• Rotação de Tokens: Renove os tokens antes da expiração
• Logs de Segurança: Monitore tentativas de acesso não autorizadas
• HTTPS: Sempre utilize conexões seguras

Validação de Credenciais

As credenciais são validadas através de:

• Verificação de existência do client_id
• Validação do client_secret associado
• Verificação do status ativo do parceiro
• Validação de permissões de acesso

Códigos de Erro

Exemplo Completo

// Exemplo em JavaScript
const authenticatePartner = async (clientId, clientSecret) => {
  try {
    const response = await fetch('https://api-h.nuvende.com.br/api/v2/partners/auth/login', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        client_id: clientId,
        client_secret: clientSecret
      })
    });

    if (!response.ok) {
      throw new Error(`Erro na autenticação: ${response.status}`);
    }

    const data = await response.json();
    return data.access_token;
  } catch (error) {
    console.error('Erro na autenticação:', error);
    throw error;
  }
};

// Uso do token
const makeAuthenticatedRequest = async (token) => {
  const response = await fetch('https://api-h.nuvende.com.br/api/v2/partners/application', {
    headers: {
      'Authorization': `Bearer ${token}`
    }
  });
  
  return response.json();
};

Próximos Passos

Após a autenticação bem-sucedida, você pode:

1. Gerenciar aplicações
2. Criar solicitações de autorização
3. Configurar webhooks