Autenticação

​

O que é OAuth 2.0?

​

Fluxo de autenticação

1. Obtenção de Credenciais: Sua aplicação usa suas credenciais (Client ID e Client Secret)
2. Solicitação de Token: Faz uma requisição direta para obter o token de acesso
3. Acesso à API: Use o token para fazer requisições à API

​

Implementação

​

1. Registrar sua aplicação

• Client ID
• Client Secret

​

2. Configurar URLs

• URL de Token: https://auth.base39.com.br/oauth2/token

​

3. Escopos disponíveis

• read: Permissão para ler dados
• write: Permissão para escrever dados

​

4. Exemplo de implementação

// Obter token diretamente com credenciais
const tokenResponse = await fetch("https://auth.base39.com.br/oauth2/token", {
  method: "POST",
  headers: {
    "Content-Type": "application/x-www-form-urlencoded",
  },
  body: new URLSearchParams({
    grant_type: "client_credentials",
    client_id: "SEU_CLIENT_ID",
    client_secret: "SEU_CLIENT_SECRET",
    scope: "read write",
  }),
});

const { access_token } = await tokenResponse.json();

// Usar o token nas requisições
const apiResponse = await fetch("https://api.base39.com.br/v1/...", {
  headers: {
    Authorization: `Bearer ${access_token}`,
  },
});

​

Segurança

• Nunca compartilhe seu Client Secret
• Sempre use HTTPS
• Armazene tokens de forma segura
• Implemente refresh tokens para renovação automática
• Revogue tokens quando não forem mais necessários
• Use credenciais específicas para cada serviço
• Monitore e audite o uso das credenciais