API SMTP - E-mail
A API SMTP da iPORTO oferece recursos completos para envio e gerenciamento de e-mails de forma programática. Esta seção contém documentação detalhada sobre todos os endpoints disponíveis.
Recursos Disponíveis
Enviar E-mail
Envie e-mails através da API com suporte a:
- HTML customizado
- Anexos
- Headers personalizados
- Tags para organização
- Configurações de rastreamento (abertura e cliques)
Endpoint: POST https://api.iporto.com.br/api/panel/application/delivery/smtp/queue/api/delivery
Ver documentação completa de envio →
Pesquisar E-mails
Consulte o histórico completo de envios com filtros avançados:
- Busca por destinatário, message ID ou tracking code
- Filtros por status de entrega
- Identificação de bounces (hard e soft)
- Busca por tags
- Filtros por período de tempo
- Paginação de resultados
Endpoint: GET https://api.iporto.com.br/api/panel/application/delivery/smtp/history
Ver documentação completa de pesquisa →
Começando
1. Obtenha seu Token de API
Para usar qualquer endpoint da API SMTP, você precisará de um Bearer Token. Você pode gerar seu token no painel de controle da iPORTO em:
Painel → Configurações → API → Gerar Token
2. Configure seus Headers
Todas as requisições devem incluir os seguintes headers:
Content-Type: application/json
Accept: application/json
Authorization: Bearer SEU_TOKEN_JWT_AQUI
3. Faça sua Primeira Requisição
Exemplo: Enviar um e-mail simples
curl --location 'https://api.iporto.com.br/api/panel/application/delivery/smtp/queue/api/delivery' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN_JWT_AQUI' \
--data-raw '{
"subject": "Meu primeiro e-mail via API",
"from": "seu-email@seudominio.com.br",
"address_to": "destinatario@exemplo.com",
"html_body": "<h1>Olá!</h1><p>Este é meu primeiro e-mail via API iPORTO.</p>"
}'
Exemplo: Buscar e-mails enviados hoje
curl --location 'https://api.iporto.com.br/api/panel/application/delivery/smtp/history?start_at=2025-12-08%2000%3A00%3A00&until_at=2025-12-08%2023%3A59%3A59' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer SEU_TOKEN_JWT_AQUI'
Autenticação
A API utiliza autenticação via Bearer Token no header Authorization. O token é específico para sua conta e deve ser mantido em segurança.
Boas Práticas de Segurança
- Nunca compartilhe seu token com terceiros
- Não exponha o token em repositórios públicos ou código cliente
- Use variáveis de ambiente para armazenar seu token
- Rotacione tokens periodicamente para maior segurança
- Revogue tokens não utilizados no painel de controle
Limites e Quotas
Os limites de uso variam de acordo com seu plano:
| Recurso | Descrição |
|---|---|
| Taxa de requisições | Varia por plano (consulte o painel) |
| Tamanho de anexos | 10MB por arquivo, máximo 10 arquivos |
| Tamanho do HTML | Máximo 1MB |
| Cache de pesquisa | 1-5 minutos dependendo da página |
Para aumentar seus limites, entre em contato com o suporte ou faça upgrade do seu plano.
Ambientes
Produção
- API de Envio:
https://api.iporto.com.br - API de Pesquisa:
https://api.iporto.com.br
Sandbox
No momento, não oferecemos ambiente sandbox. Todos os e-mails enviados através da API são reais e serão entregues aos destinatários.
Recomendação: Use endereços de e-mail de teste da sua própria organização durante o desenvolvimento.
Códigos de Status HTTP
| Código | Descrição |
|---|---|
200 |
Requisição bem-sucedida |
400 |
Erro de validação nos dados enviados |
401 |
Token de autenticação inválido ou ausente |
403 |
Acesso negado |
422 |
Entidade não processável (dados inválidos) |
429 |
Muitas requisições (limite de taxa excedido) |
500 |
Erro interno do servidor |
Suporte
Documentação
- Enviar E-mail - Documentação completa do endpoint de envio
- Pesquisar E-mails - Documentação completa do endpoint de pesquisa
Ajuda
Para dúvidas ou problemas:
- Acesse o painel de suporte em smtp.iporto.com.br
- Entre em contato através do site oficial
- Consulte a documentação da aplicação web
Recursos Adicionais
SDKs e Bibliotecas
No momento, não oferecemos SDKs oficiais. No entanto, nossa API REST pode ser facilmente integrada com qualquer linguagem de programação que suporte requisições HTTP.
Webhooks
Para receber notificações em tempo real sobre eventos de e-mail (abertura, cliques, bounces), configure webhooks no painel de controle.
Exemplos de Código
Todos os endpoints incluem exemplos em múltiplas linguagens:
- cURL
- PHP
- Python
- JavaScript (Node.js)