Primeiros passos com a API
Faça sua primeira chamada à API em minutos. Aprenda a criar uma chave de API, autenticar requisições e integrar os serviços da Meirra.
Visão geral
A API da Meirra oferece acesso programático aos nossos serviços de verificação de e-mail, enriquecimento de contatos, geração de leads e análise de SEO. Com uma interface REST simples e preços pré-pagos, você pode integrar ferramentas de dados poderosas diretamente nas suas aplicações. Este guia leva você passo a passo pela criação da sua primeira chave de API e da sua primeira requisição.
Criar uma chave de API
Para usar a API você precisa de uma chave. Faça login na sua conta Meirra e abra o Painel do Desenvolvedor. Clique em 'Criar chave de API' e dê um nome descritivo (por exemplo, 'App de produção' ou 'Testes'). Sua chave aparece uma única vez — copie e guarde com segurança. As chaves de API começam com 'mk_live_' em produção ou 'mk_test_' em ambientes de teste.
Sua primeira requisição
Vamos verificar um endereço de e-mail. Inclua sua chave de API no cabeçalho x-api-key: ```bash curl -X POST https://api.meirra.com/v1/email/verify \ -H "x-api-key: mk_live_sua_chave_aqui" \ -H "Content-Type: application/json" \ -d '{"email": "test@example.com"}' ``` Você receberá uma resposta JSON com o resultado da verificação, incluindo se o e-mail é válido, entregável e indicadores de risco.
Formato de resposta
Todas as respostas da API seguem um formato consistente: ```json { "success": true, "data": { ... }, "usage": { "cost": 0.005, "balanceRemaining": 19.995 } } ``` O campo `success` indica se a requisição teve sucesso. `data` contém o resultado. `usage` mostra o custo da requisição e o seu saldo restante.
Próximos passos
Agora que fez sua primeira requisição, explore mais endpoints: • **Verificação de e-mail** — verifique e-mails individuais ou processe lotes de até 100 de uma vez • **Enriquecimento de contatos** — encontre e-mails de contatos por nome e empresa • **Enriquecimento de empresas** — obtenha todos os contatos de um domínio corporativo • **Busca de leads** — pesquise empresas no Google Maps ou em registros oficiais • **Análise de SEO** — execute testes de PageSpeed, acompanhe palavras-chave e gere auditorias Lembre-se de conferir seu saldo com frequência e recarregar quando necessário para evitar interrupções do serviço.
Artigos relacionados
Autenticação
Mergulhe no gerenciamento de chaves de API, listas de IPs permitidos e boas práticas de segurança.
Verificação de e-mail
Conheça os endpoints de verificação de e-mail individual e em lote.
Endpoints de leads
Busque leads de negócio no Google Maps em mais de 200 países. Encontre empresas locais com seus sites, telefones e endereços.
Limites de taxa
Entenda os limites de taxa da API, os cabeçalhos de resposta e as boas práticas para tratar erros de limite com elegância.