Authorization: Bearer train_sk_1234567890abcdef

{
  "from": {
    "email": "sender@yourdomain.com",
    "name": "John Sender"
  },
  "to": [
    {
      "email": "recipient@example.com",
      "name": "Jane Recipient"
    },
    {
      "email": "another@example.com"
    }
  ],
  "cc": [
    {
      "email": "cc@example.com",
      "name": "CC Person"
    }
  ],
  "subject": "Your order #12345 has been shipped",
  "html": "
Order Shipped!
Your order is on its way.
",
  "text": "Order Shipped! Your order is on its way.",
  "tags": ["order", "shipping"],
  "track_opens": true,
  "track_clicks": true
}

{
  "success": true,
  "data": {
    "id": "msg_abc123def456",
    "status": "delivered",
    "from": {
      "email": "sender@yourdomain.com",
      "name": "John Sender"
    },
    "to": [
      {
        "email": "recipient@example.com",
        "name": "Jane Recipient"
      }
    ],
    "subject": "Your order #12345 has been shipped",
    "created_at": "2025-12-01T03:46:00Z",
    "sent_at": "2025-12-01T03:46:05Z",
    "delivered_at": "2025-12-01T03:46:12Z",
    "opened_at": "2025-12-01T04:15:30Z",
    "opens_count": 3,
    "clicks_count": 1,
    "tags": ["order", "shipping"],
    "events": [
      {
        "type": "sent",
        "timestamp": "2025-12-01T03:46:05Z"
      },
      {
        "type": "delivered",
        "timestamp": "2025-12-01T03:46:12Z"
      },
      {
        "type": "opened",
        "timestamp": "2025-12-01T04:15:30Z"
      }
    ]
  }
}

{
  "email": "support@yourdomain.com",
  "name": "Customer Support",
  "forward_to": ["team@internal.com"],
  "auto_reply": {
    "enabled": true,
    "subject": "We received your message",
    "body": "Thank you for contacting us. We'll respond within 24 hours."
  }
}

{
  "success": true,
  "data": {
    "messages": [
      {
        "id": "msg_xyz789abc123",
        "from": {
          "email": "customer@example.com",
          "name": "Customer Name"
        },
        "to": "support@yourdomain.com",
        "subject": "Question about pricing",
        "received_at": "2025-12-01T03:46:00Z",
        "size": 15420,
        "has_attachments": false,
        "is_read": false
      }
    ],
    "total": 42,
    "limit": 50,
    "offset": 0
  }
}

{
  "domain": "yourdomain.com",
  "region": "eu"
}

{
  "name": "welcome-email",
  "subject": "Welcome to {{company_name}}, {{user_name}}!",
  "html": "

{
  "from": "noreply@yourdomain.com",
  "to": "newuser@example.com",
  "template": "welcome-email",
  "variables": {
    "company_name": "Acme Corp",
    "user_name": "John Doe",
    "user_email": "newuser@example.com",
    "activation_link": "https://yourdomain.com/activate/abc123"
  }
}

{
  "from": "sender@yourdomain.com",
  "to": "recipient@example.com",
  "subject": "Invoice attached",
  "html": "
Please find your invoice attached.
",
  "attachments": [
    {
      "filename": "invoice-2025-12.pdf",
      "content": "JVBERi0xLjQKJeLjz9MKNCAwIG9...",
      "content_type": "application/pdf",
      "disposition": "attachment"
    },
    {
      "filename": "logo.png",
      "content": "iVBORw0KGgoAAAANSUhEUgAAA...",
      "content_type": "image/png",
      "disposition": "inline",
      "content_id": "logo"
    }
  ]
}

{
  "from": "sender@yourdomain.com",
  "to": "recipient@example.com",
  "subject": "Report attached",
  "html": "
Monthly report is attached.
",
  "attachments": [
    {
      "filename": "report.pdf",
      "url": "https://yourdomain.com/files/report-2025-12.pdf"
    }
  ]
}

{
  "from": "sender@yourdomain.com",
  "to": "recipient@example.com",
  "subject": "Newsletter",
  "html": "
Our Newsletter
Content here...
",
  "attachments": [
    {
      "filename": "header.jpg",
      "content": "iVBORw0KGgoAAAANSUhEUgAAA...",
      "content_type": "image/jpeg",
      "disposition": "inline",
      "content_id": "header-image"
    }
  ]
}

import requests
import base64

# Read and encode file
with open('document.pdf', 'rb') as file:
    encoded_file = base64.b64encode(file.read()).decode('utf-8')

payload = {
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "subject": "Document attached",
    "html": "
Please find the document attached.
",
    "attachments": [
        {
            "filename": "document.pdf",
            "content": encoded_file,
            "content_type": "application/pdf"
        }
    ]
}

response = requests.post(
    "https://api.trainmail.online/v1/emails/send",
    json=payload,
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
print(response.json())

{
  "url": "https://yourdomain.com/webhooks/trainmail",
  "events": ["email.sent", "email.delivered", "email.opened", "email.clicked"],
  "description": "Production webhook",
  "secret": "your_webhook_secret_key"
}

{
  "event": "email.opened",
  "timestamp": "2025-12-01T03:46:00Z",
  "webhook_id": "wh_abc123def456",
  "data": {
    "email_id": "msg_xyz789abc123",
    "from": "sender@yourdomain.com",
    "to": "recipient@example.com",
    "subject": "Your order has shipped",
    "opened_at": "2025-12-01T04:15:30Z",
    "user_agent": "Mozilla/5.0...",
    "ip_address": "192.168.1.1",
    "location": {
      "country": "US",
      "city": "New York"
    }
  }
}

import hmac
import hashlib

def verify_webhook(payload, signature, secret):
    computed_signature = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    
    return hmac.compare_digest(computed_signature, signature)

# В вашем webhook-обработчике
@app.route('/webhooks/trainmail', methods=['POST'])
def handle_webhook():
    payload = request.get_data(as_text=True)
    signature = request.headers.get('X-TrainMail-Signature')
    
    if not verify_webhook(payload, signature, WEBHOOK_SECRET):
        return 'Invalid signature', 401
    
    event_data = request.json
    # Обработка события
    return 'OK', 200

from trainmail import TrainMail

# Инициализация клиента
client = TrainMail(api_key='train_sk_1234567890abcdef')

# Отправка письма
email = client.emails.send(
    from_email='sender@yourdomain.com',
    to='recipient@example.com',
    subject='Hello from Python SDK',
    html='
Welcome!
This email was sent using Python SDK.
',
    text='Welcome! This email was sent using Python SDK.'
)

print(f"Email sent with ID: {email.id}")

# Получение информации о письме
email_info = client.emails.get(email.id)
print(f"Status: {email_info.status}")

# Список писем
emails = client.emails.list(limit=10, status='delivered')
for email in emails:
    print(f"{email.subject} - {email.status}")

# Создание шаблона
template = client.templates.create(
    name='welcome-python',
    subject='Welcome {{name}}!',
    html='
Hello {{name}}!
'
)

# Отправка с шаблоном
client.emails.send(
    from_email='sender@yourdomain.com',
    to='recipient@example.com',
    template='welcome-python',
    variables={'name': 'John Doe'}
)

const TrainMail = require('trainmail');

// Инициализация клиента
const client = new TrainMail('train_sk_1234567890abcdef');

// Отправка письма
async function sendEmail() {
  const email = await client.emails.send({
    from: 'sender@yourdomain.com',
    to: 'recipient@example.com',
    subject: 'Hello from Node.js SDK',
    html: '
Welcome!
This email was sent using Node.js SDK.
',
    text: 'Welcome! This email was sent using Node.js SDK.'
  });
  
  console.log(`Email sent with ID: ${email.id}`);
  
  // Получение информации о письме
  const emailInfo = await client.emails.get(email.id);
  console.log(`Status: ${emailInfo.status}`);
}

// Работа с шаблонами
async function useTemplate() {
  const template = await client.templates.create({
    name: 'welcome-nodejs',
    subject: 'Welcome {{name}}!',
    html: '
Hello {{name}}!
'
  });
  
  await client.emails.send({
    from: 'sender@yourdomain.com',
    to: 'recipient@example.com',
    template: 'welcome-nodejs',
    variables: { name: 'John Doe' }
  });
}

sendEmail().catch(console.error);

emails->send([
    'from' => 'sender@yourdomain.com',
    'to' => 'recipient@example.com',
    'subject' => 'Hello from PHP SDK',
    'html' => '
Welcome!
This email was sent using PHP SDK.
',
    'text' => 'Welcome! This email was sent using PHP SDK.'
]);

echo "Email sent with ID: " . $email->id . "\n";

// Получение информации о письме
$emailInfo = $client->emails->get($email->id);
echo "Status: " . $emailInfo->status . "\n";

// Список писем
$emails = $client->emails->list(['limit' => 10, 'status' => 'delivered']);
foreach ($emails as $email) {
    echo $email->subject . " - " . $email->status . "\n";
}

// Создание шаблона
$template = $client->templates->create([
    'name' => 'welcome-php',
    'subject' => 'Welcome {{name}}!',
    'html' => '
Hello {{name}}!
'
]);

// Отправка с шаблоном
$client->emails->send([
    'from' => 'sender@yourdomain.com',
    'to' => 'recipient@example.com',
    'template' => 'welcome-php',
    'variables' => ['name' => 'John Doe']
]);
?>

package main

import (
    "fmt"
    "github.com/trainmail/trainmail-go"
)

func main() {
    // Инициализация клиента
    client := trainmail.NewClient("train_sk_1234567890abcdef")
    
    // Отправка письма
    email, err := client.Emails.Send(&trainmail.EmailRequest{
        From:    "sender@yourdomain.com",
        To:      []string{"recipient@example.com"},
        Subject: "Hello from Go SDK",
        HTML:    "
Welcome!
This email was sent using Go SDK.
",
        Text:    "Welcome! This email was sent using Go SDK.",
    })
    
    if err != nil {
        panic(err)
    }
    
    fmt.Printf("Email sent with ID: %s\n", email.ID)
    
    // Получение информации о письме
    emailInfo, err := client.Emails.Get(email.ID)
    if err != nil {
        panic(err)
    }
    
    fmt.Printf("Status: %s\n", emailInfo.Status)
    
    // Список писем
    emails, err := client.Emails.List(&trainmail.ListOptions{
        Limit:  10,
        Status: "delivered",
    })
    
    for _, email := range emails {
        fmt.Printf("%s - %s\n", email.Subject, email.Status)
    }
}

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1638360000
X-RateLimit-Burst: 100

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please retry after 30 seconds.",
    "retry_after": 30
  }
}

import time
import requests

def send_email_with_retry(payload, max_retries=3):
    for attempt in range(max_retries):
        try:
            response = requests.post(
                'https://api.trainmail.online/v1/emails/send',
                json=payload,
                headers={'Authorization': 'Bearer YOUR_API_KEY'}
            )
            
            if response.status_code == 429:
                # Получаем время ожидания из заголовка
                retry_after = int(response.headers.get('Retry-After', 60))
                print(f"Rate limit exceeded. Waiting {retry_after} seconds...")
                time.sleep(retry_after)
                continue
            
            response.raise_for_status()
            return response.json()
            
        except requests.exceptions.RequestException as e:
            if attempt == max_retries - 1:
                raise
            # Экспоненциальная задержка
            wait_time = (2 ** attempt) * 1
            print(f"Attempt {attempt + 1} failed. Retrying in {wait_time}s...")
            time.sleep(wait_time)
    
    raise Exception("Max retries exceeded")

{
  "error": {
    "code": "validation_error",
    "message": "Invalid email address format",
    "field": "to",
    "details": {
      "to": "Must be a valid email address"
    }
  }
}

import requests

def send_email(payload):
    try:
        response = requests.post(
            'https://api.trainmail.online/v1/emails/send',
            json=payload,
            headers={'Authorization': 'Bearer YOUR_API_KEY'}
        )
        response.raise_for_status()
        return response.json()
        
    except requests.exceptions.HTTPError as e:
        error_data = e.response.json()
        error_code = error_data['error']['code']
        error_message = error_data['error']['message']
        
        if e.response.status_code == 429:
            print(f"Rate limit exceeded: {error_message}")
            # Реализуйте retry логику
        elif e.response.status_code == 422:
            print(f"Validation error: {error_message}")
            print(f"Details: {error_data['error'].get('details')}")
        else:
            print(f"Error {e.response.status_code}: {error_message}")
        
        raise
        
    except requests.exceptions.RequestException as e:
        print(f"Network error: {str(e)}")
        raise