Skip to main content

​
Autenticação na API Speedio

A API Speedio utiliza Basic Authentication para autenticar suas requisições. Este método é simples, seguro e amplamente suportado.

​
Como Funciona

A autenticação Basic Auth funciona enviando suas credenciais codificadas em Base64 no header Authorization de cada requisição. 
Authorization: Basic base64(username:password)

​
Fluxo de Autenticação

1

Obtenha suas Credenciais

Entre em contato com a equipe Speedio para receber suas credenciais de acesso:
  • Username: Seu nome de usuário único
  • Password: Sua senha de acesso
2

Configure Variáveis de Ambiente

Por motivos de segurança, configure suas credenciais como variáveis de ambiente:
export SPEEDIO_USERNAME="seu_usuario"
export SPEEDIO_PASSWORD="sua_senha"
3

Codifique em Base64

Combine username e password separados por : e codifique em Base64:
echo -n "${SPEEDIO_USERNAME}:${SPEEDIO_PASSWORD}" | base64
4

Inclua no Header

Adicione o header Authorization em todas as requisições:
curl -H "Authorization: Basic dGVzdHVzZXI6c3BkdGVzdHVzZXI=" \
     'https://api-get-leads.speedio.com.br/endpoint'

​
Exemplo Prático

# Configure as variáveis de ambiente primeiro
export SPEEDIO_USERNAME="seu_usuario"
export SPEEDIO_PASSWORD="sua_senha"

# Faça a requisição
curl -H "Authorization: Basic $(echo -n ${SPEEDIO_USERNAME}:${SPEEDIO_PASSWORD} | base64)" \
     -H "Content-Type: application/json" \
     'https://api-get-leads.speedio.com.br/search_enriched_leads/cnpj?cnpjs=["21071712000171"]'

​
Códigos de Status de Autenticação

StatusDescriçãoSolução
200✅ Autenticação bem-sucedidaContinue normalmente
401❌ Credenciais inválidasVerifique username e password
403❌ Acesso negadoVerifique permissões da conta
429⚠️ Limite de taxa excedidoAguarde antes de tentar novamente

​
Melhores Práticas de Segurança

✅ Faça

  • Use variáveis de ambiente
  • Rotacione credenciais regularmente
  • Use HTTPS sempre
  • Monitore uso da API

❌ Não Faça

  • Hardcode credenciais no código
  • Compartilhe credenciais
  • Use HTTP (sem SSL)
  • Ignore logs de segurança

​
Testando sua Autenticação

Para verificar se suas credenciais estão funcionando: 
# Teste rápido
curl -I -H "Authorization: Basic $(echo -n ${SPEEDIO_USERNAME}:${SPEEDIO_PASSWORD} | base64)" \
     'https://api-get-leads.speedio.com.br/search_enriched_leads/cnpj?cnpjs=["21071712000171"]'
Se você receber um status 200, sua autenticação está funcionando corretamente.
Importante: Mantenha suas credenciais seguras. Se suspeitar que foram comprometidas, entre em contato imediatamente com nossa equipe de suporte.

​
Próximos Passos

Configuração Detalhada

Configure suas credenciais em diferentes ambientes

Primeira Requisição

Faça sua primeira chamada à API