Email API | Código Capixaba

📧 Bem-vindo à Email API

API RESTful para envio de emails de forma simples e segura. Ideal para integração com seus sistemas, websites e aplicações.

Recursos principais:

Envio de emails com HTML personalizado
Autenticação segura via API Key
Resposta rápida e confiável
Suporte a formatação rica de conteúdo

🔐 Autenticação

⚠️ API Key Obrigatória
Todas as requisições devem incluir sua chave de autenticação no header.

Header Necessário:

x-api-key: SUA_API_KEY_AQUI

Ainda não possui uma API Key? Solicite gratuitamente

🚀 Endpoint

POST https://mail.codigocapixaba.com.br/send-email

Parâmetros do Body (JSON):

Parâmetro	Tipo	Obrigatório	Descrição
`toEmail`	string	✓ Sim	Email do destinatário
`subject`	string	✓ Sim	Assunto do email
`text`	string	✓ Sim	Conteúdo do email (aceita HTML)

💻 Exemplos de Uso

JavaScript (Fetch API):

fetch("https://mail.codigocapixaba.com.br/send-email", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "SUA_API_KEY_AQUI"
  },
  body: JSON.stringify({
    toEmail: "destinatario@email.com",
    subject: "Teste de Envio",
    text: "Olá! Este é um email de teste com <strong>HTML</strong>!"
  })
})
  .then(res => res.json())
  .then(data => console.log("✓ Email enviado:", data))
  .catch(err => console.error("✗ Erro:", err));

cURL:

curl -X POST https://mail.codigocapixaba.com.br/send-email \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY_AQUI" \
  -d '{
    "toEmail": "destinatario@email.com",
    "subject": "Teste de Envio",
    "text": "Olá! Este é um email de teste."
  }'

Node.js (Axios):

const axios = require('axios');

axios.post('https://mail.codigocapixaba.com.br/send-email', {
  toEmail: 'destinatario@email.com',
  subject: 'Teste de Envio',
  text: 'Olá! Este é um email de teste com <strong>HTML</strong>!'
}, {
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'SUA_API_KEY_AQUI'
  }
})
  .then(response => console.log('✓ Email enviado:', response.data))
  .catch(error => console.error('✗ Erro:', error));

💡 Dica: O campo text suporta HTML completo. Você pode usar tags como <strong>, <em>, <ul>, <div>, <img>, e muito mais para personalizar seus emails.

📨 Respostas da API

Sucesso (200 OK):

{
  "sucesso": true,
  "mensagem": "Email enviado com sucesso"
}

Erro de Autenticação (401 Unauthorized):

{
  "sucesso": false,
  "mensagem": "API Key inválida ou não fornecida"
}

Erro de Validação (400 Bad Request):

{
  "sucesso": false,
  "mensagem": "Parâmetros obrigatórios ausentes"
}

Documentação da API de Email