Mail Proxy API

ส่งแบบพื้นฐาน

curl -sS -X POST https://mailproxy.ipv9.me/api/v1/send \
  -H "X-API-Key: $MAILPROXY_KEY" -H 'Content-Type: application/json' \
  -d '{"to":"user@example.com","subject":"Test","body":"Hello from Mail Proxy"}'

หลายผู้รับ + CC/BCC + ชื่อผู้ส่ง

curl -sS -X POST https://mailproxy.ipv9.me/api/v1/send \
  -H "X-API-Key: $MAILPROXY_KEY" -H 'Content-Type: application/json' \
  -d '{
    "to": ["ops1@example.com","ops2@example.com"],
    "cc": ["lead@example.com"],
    "bcc": ["audit@example.com"],
    "sender_name": "ระบบงานตรวจสอบ",
    "subject": "สรุปผลตรวจประจำวัน",
    "body": "ผ่าน 42 รายการ / ไม่ผ่าน 0 รายการ"
  }'

HTML body

curl -sS -X POST https://mailproxy.ipv9.me/api/v1/send \
  -H "X-API-Key: $MAILPROXY_KEY" -H 'Content-Type: application/json' \
  -d '{"to":"user@example.com","subject":"Report","html":true,
       "body":"<h2>Daily report</h2><p style=\"color:#1a7f37\">All systems OK</p>"}'

อ่าน key จากไฟล์ (key ไม่อยู่ใน argv และไม่โผล่ใน ps)

# /etc/myapp.key (0600) มี 1 บรรทัด: X-API-Key: mp_...
curl -sS -X POST https://mailproxy.ipv9.me/api/v1/send -H @/etc/myapp.key \
  -H 'Content-Type: application/json' -d @payload.json

Script แจ้งเตือนเมื่อคำสั่งล้มเหลว (ใช้กับ cron ได้)

#!/bin/sh
# usage: notify-on-fail.sh <command...>   — ส่งเมลเมื่อ command จบด้วย exit ≠ 0
out=$("$@" 2>&1); rc=$?
[ $rc -eq 0 ] && exit 0
payload=$(python3 -c 'import json,sys,socket
print(json.dumps({"to":"ops@example.com","sender_name":"Cron Monitor",
 "subject":f"[FAIL] {socket.gethostname()}: {sys.argv[1]} (rc={sys.argv[2]})",
 "body":sys.argv[3][-4000:]}))' "$*" "$rc" "$out")
curl -sS --max-time 30 -X POST https://mailproxy.ipv9.me/api/v1/send \
  -H @/etc/notify.key -H 'Content-Type: application/json' -d "$payload" \
  | grep -q '"success":true' || logger -t notify "mailproxy send failed"
exit $rc

ใช้ใน crontab: 0 2 * * * /usr/local/bin/notify-on-fail.sh /opt/backup/run.sh

Python (requests) พร้อม retry เมื่อโดน 429 หรือ 503

import os, time, requests

URL = "https://mailproxy.ipv9.me/api/v1/send"
HDR = {"X-API-Key": os.environ["MAILPROXY_KEY"]}

def send_mail(to, subject, body, html=False, retries=3, **extra):
    payload = {"to": to, "subject": subject, "body": body, "html": html, **extra}
    for attempt in range(retries):
        r = requests.post(URL, json=payload, headers=HDR, timeout=30)
        if r.status_code == 200:
            return r.json()["message_id"]
        if r.status_code == 429:                       # rate limited
            time.sleep(int(r.headers.get("Retry-After", 60)))
        elif r.status_code == 503:                     # SMTP relay error
            time.sleep(2 ** attempt * 5)
        else:                                          # 401/403/422: ไม่ต้อง retry
            raise RuntimeError(f"{r.status_code}: {r.text}")
    raise RuntimeError("mailproxy: retries exhausted")

send_mail(["a@example.com", "b@example.com"], "Backup done", "OK",
          sender_name="Backup Bot", cc=["lead@example.com"])

Python stdlib (ไม่ต้องติดตั้ง package)

import json, os, urllib.request

req = urllib.request.Request(
    "https://mailproxy.ipv9.me/api/v1/send/template",
    data=json.dumps({
        "to": "ops@example.com",
        "template": "system",
        "sender_name": "Disk Monitor",
        "data": {"hostname": os.uname().nodename, "alert_type": "Disk usage",
                 "severity": "WARNING", "message": "/var at 91%"}
    }).encode(),
    headers={"X-API-Key": os.environ["MAILPROXY_KEY"], "Content-Type": "application/json"},
)
print(json.load(urllib.request.urlopen(req, timeout=30)))

Node.js 18+ (ใช้ fetch ที่มีในตัว)

const res = await fetch("https://mailproxy.ipv9.me/api/v1/send", {
  method: "POST",
  headers: { "X-API-Key": process.env.MAILPROXY_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    to: ["dev@example.com"],
    subject: `Deploy ${process.env.APP_VERSION} finished`,
    body: "Deploy succeeded",
    html: true,
    sender_name: "CI/CD",
  }),
});
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
console.log(await res.json(), "remaining:", res.headers.get("x-ratelimit-remaining"));

PHP (cURL)

<?php
$ch = curl_init('https://mailproxy.ipv9.me/api/v1/send');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('MAILPROXY_KEY'), 'Content-Type: application/json'],
  CURLOPT_POSTFIELDS => json_encode([
    'to' => 'user@example.com',
    'subject' => 'แจ้งเตือนจากระบบ',
    'body' => 'ข้อความภาษาไทยรองรับ UTF-8',
    'sender_name' => 'ระบบสารสนเทศ',
  ], JSON_UNESCAPED_UNICODE),
]);
$resp = json_decode(curl_exec($ch), true);
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($code !== 200) { error_log("mailproxy $code: " . json_encode($resp)); }

PowerShell (Windows)

$body = @{
  to          = @("helpdesk@example.com")
  subject     = "[Windows] $env:COMPUTERNAME service stopped"
  body        = (Get-Service Spooler | Out-String)
  sender_name = "Windows Monitor"
} | ConvertTo-Json

Invoke-RestMethod -Method Post -Uri "https://mailproxy.ipv9.me/api/v1/send" `
  -Headers @{ "X-API-Key" = $env:MAILPROXY_KEY } `
  -ContentType "application/json; charset=utf-8" `
  -Body ([System.Text.Encoding]::UTF8.GetBytes($body))

n8n: HTTP Request node

{
  "to": "{{ $json.email }}",
  "subject": "Ticket #{{ $json.id }} updated",
  "body": "{{ $json.summary }}",
  "sender_name": "Service Desk"
}

ตั้ง Options → Retry On Fail = 3 และ Wait Between Tries = 60000 ms เพื่อรองรับกรณีโดน 429