Verificação de email

Checa sintaxe, registros MX e, opcionalmente, faz uma sondagem SMTP, pra saber se um email tem chance real de existir antes de mandar algo pra ele.

Email verification

Checks syntax, MX records and, optionally, runs an SMTP probe, to know whether an email actually has a chance of existing before you send anything to it.

SYNC resposta na mesma chamada answers in the same call

Endpoint

GET /api/v1/email/verify verifica um endereço de email verifies an email address

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`email`	query	obrigatório: o endereço a verificar	required: the address to check

Exemplo

Example

curl "https://api.alicercelabs.com.br/api/v1/email/verify?email=voce@exemplo.com" \
          -H "Authorization: Bearer <token>"

{
          "success": true,
          "data": {
            "email": "voce@exemplo.com",
            "reachable": "unknown",
            "syntax_valid": true,
            "has_mx": true,
            "disposable": false,
            "role_account": false,
            "free": false
          },
          "meta": { "elapsed_ms": 6, "request_id": "..." }
        }

reachable só vira "yes"/"no" quando a checagem SMTP está habilitada; do contrário fica "unknown" e a resposta se baseia só em sintaxe + MX.

reachable only becomes "yes"/"no" when SMTP checking is enabled; otherwise it stays "unknown" and the response is based on syntax + MX alone.

Erros possíveis

Possible errors

Status	Motivo	Reason
400	parâmetro `email` ausente ou com formato inválido	missing or malformed `email` parameter
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido (da API), ou muitas checagens SMTP pro mesmo domínio	API rate limit exceeded, or too many SMTP probes against the same domain
503	erro ao verificar (falha na sondagem SMTP)	verification failed (SMTP probe error)
503	verificador não disponível nesse ambiente	verifier not available on this environment

Usando o SDK

Using the SDK

Um método só: sintaxe, MX e (se habilitado no servidor) probe SMTP.

Just one method: syntax, MX records and (if enabled server-side) an SMTP probe.

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Verificar um email

Verify an email

import (
	"context"
	"fmt"

	alicercelabs "github.com/alicercelabs/alicercesdk-go"
)

client := alicercelabs.New("alk_...")
ctx := context.Background()

res, err := client.Email.Verify(ctx, "contato@empresa.com.br")
if err != nil {
	panic(err)
}
fmt.Println(res.Valid, res.MXFound, res.Disposable)

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")

res = client.email.verify("contato@empresa.com.br")
print(res["valid"], res["mx_found"], res["disposable"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_...");

const res = await client.email.verify("contato@empresa.com.br");
console.log(res.valid, res.mx_found, res.disposable);

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com uma API key (gerada no painel), 1.000/dia · 41/hora. Quando a sondagem SMTP está ligada, existe um limite adicional, por domínio de destino, pra não ser confundido com abuso pelos servidores de email de terceiros.

100/day · 4/hour without a token, per calling IP; with an API key (generated in the panel), 1,000/day · 41/hour. When SMTP probing is on, there's an additional per-destination-domain limit, so we don't get flagged as abuse by third-party mail servers.