Início Rápido
Este guia irá ajudá-lo a fazer sua primeira chamada à API Speedio em poucos minutos.
Por motivos de segurança, sempre use variáveis de ambiente para suas credenciais:
# Configure as variáveis de ambiente
export SPEEDIO_USERNAME="seu_usuario"
export SPEEDIO_PASSWORD="sua_senha"
Nunca inclua suas credenciais diretamente no código. Sempre use variáveis de ambiente.
2. Sua Primeira Chamada
Vamos buscar informações sobre uma empresa usando seu CNPJ:
# Configure as variáveis primeiro
export SPEEDIO_USERNAME="seu_usuario"
export SPEEDIO_PASSWORD="sua_senha"
curl -G \
-H "Authorization: Basic $(echo -n ${SPEEDIO_USERNAME}:${SPEEDIO_PASSWORD} | base64)" \
-H "Content-Type: application/json" \
--data-urlencode 'cnpjs=["21071712000171"]' \
'https://api-get-leads.speedio.com.br/search_enriched_leads/cnpj'
3. Exemplo de Resposta
A API retornará informações detalhadas sobre a empresa:
[
{
"cnpj": "21071712000171",
"razao_social": "SPEED IO - SERVICOS ESPECIALIZADOS LTDA",
"nome_fantasia": "SPEEDIO",
"location": {
"uf": "ES",
"city": "Colatina",
"bairro": "CENTRO",
"cep": "29700010",
"tipo_logradouro": "AVENIDA",
"nome_rua": "GETULIO VARGAS",
"numero": "196"
},
"website": "https://speedio.com.br/",
"faixa_faturamento_cnpj": "10M a 30M",
"faixa_faturamento_empresa": "10M a 30M",
"qnt_funcionario_cnpj": "51 a 100",
"qnt_funcionario_empresa": "51 a 100",
"telefones": {
"telefones_validados": [],
"telefones_contador": [],
"telefones_invalidos": ["11994154146, 1132803375, 11949141380, 1131631068"]
},
"generic_emails": {
"emails_validados": [],
"emails_contador": [],
"emails_invalidos": ["[email protected]", "[email protected]"]
},
"qsa": [
{
"name": "EDUARDO BRENNAND CAMPOS",
"position": "Sócio"
},
{
"name": "DIOGO NASCIMENTO PUBLIO PEREIRA",
"position": "Sócio-Administrador"
}
],
"administrador": "EDUARDO BRENNAND CAMPOS",
"data_abertura": "19/09/2014",
"idade_empresa": "10 anos",
"qnt_filiais": 0,
"natureza_juridica": "2062",
"cnae_primario": {
"cnae": "6203100",
"cnae_desc": "Desenvolvimento e licenciamento de programas de computador não-customizáveis"
},
"cnae_secundario": [
{
"cnae": "6491300",
"cnae_desc": "Sociedades de fomento mercantil - factoring"
}
]
}
]
4. Tratamento de Erros
Sempre implemente tratamento de erros adequado:
try {
const dados = await buscarEmpresa('21071712000171');
console.log('Sucesso!', dados);
} catch (error) {
if (error.response?.status === 401) {
console.error('Credenciais inválidas');
} else if (error.response?.status === 429) {
console.error('Limite de requisições excedido');
} else {
console.error('Erro na API:', error.message);
}
}
5. Próximos Passos
Agora que você fez sua primeira chamada, explore mais recursos:
Dúvidas?
Precisa de Ajuda?
Nossa equipe está pronta para ajudar você
