邮件发送接口对接文档

所有响应均为 JSON，结构固定为三个字段：

成功响应

{
  "code": 0,
  "msg": "发送成功",
  "data": {
    "log_id": 1024,      // 日志编号，可用于对账
    "cost_ms": 428,     // 发送耗时（毫秒）
    "account": "客服邮箱"  // 实际使用的发信账号名
  }
}

失败响应

{
  "code": 1,
  "msg": "收件人邮箱格式不正确",
  "data": {
    "log_id": 0,
    "cost_ms": 12
  }
}

PHP（cURL，推荐）

<?php
$payload = [
    'to'      => 'someone@example.com',
    'subject' => '您的订单已发货',
    'body'    => '<p>您好，您的订单 <strong>#12345</strong> 已发货。</p>',
    'template' => true,
];

$ch = curl_init('https://ai.maggiemi.cn/api/send.php');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_TIMEOUT        => 30,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'X-API-Key: 你的密钥',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$res  = curl_exec($ch);
$err  = curl_error($ch);
curl_close($ch);

if ($err) {
    exit('请求失败：' . $err);
}

$data = json_decode($res, true);
if (isset($data['code']) && $data['code'] === 0) {
    echo '发送成功，日志编号 ' . $data['data']['log_id'];
} else {
    echo '发送失败：' . ($data['msg'] ?? '未知错误');
}

PHP（file_get_contents）

<?php
$payload = json_encode([
    'to'      => 'someone@example.com',
    'subject' => '测试邮件',
    'body'    => '<p>这是一封测试邮件</p>',
], JSON_UNESCAPED_UNICODE);

$ctx = stream_context_create([
    'http' => [
        'method'  => 'POST',
        'header'  => "Content-Type: application/json\r\n"
                   . "X-API-Key: 你的密钥\r\n",
        'content' => $payload,
        'timeout' => 30,
    ],
]);

$res  = file_get_contents('https://ai.maggiemi.cn/api/send.php', false, $ctx);
$data = json_decode($res, true);
var_dump($data);

Python（requests）

import requests

url = 'https://ai.maggiemi.cn/api/send.php'
headers = {
    'X-API-Key': '你的密钥',
}

payload = {
    'to': 'someone@example.com',
    'subject': '测试邮件',
    'body': '<p>这是一封测试邮件</p>',
    'template': True,
}

try:
    res = requests.post(url, headers=headers, json=payload, timeout=30)
    data = res.json()
    if data.get('code') == 0:
        print('发送成功：', data['data']['log_id'])
    else:
        print('发送失败：', data.get('msg'))
except requests.RequestException as e:
    print('请求异常：', e)

Node.js（原生 fetch，Node 18+）

const res = await fetch('https://ai.maggiemi.cn/api/send.php', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': '你的密钥',
  },
  body: JSON.stringify({
    to: 'someone@example.com',
    subject: '测试邮件',
    body: '<p>这是一封测试邮件</p>',
  }),
});

const data = await res.json();
if (data.code === 0) {
  console.log('发送成功', data.data.log_id);
} else {
  console.error('发送失败', data.msg);
}

Java（OkHttp）

OkHttpClient client = new OkHttpClient.Builder()
        .connectTimeout(10, TimeUnit.SECONDS)
        .readTimeout(30, TimeUnit.SECONDS)
        .build();

String json = "{\"to\":\"someone@example.com\","
        + "\"subject\":\"测试邮件\","
        + "\"body\":\"<p>正文</p>\"}";

RequestBody body = RequestBody.create(
        json, MediaType.parse("application/json; charset=utf-8"));

Request request = new Request.Builder()
        .url("https://ai.maggiemi.cn/api/send.php")
        .addHeader("X-API-Key", "你的密钥")
        .post(body)
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

Shell / 定时任务

#!/bin/bash
API_URL="https://ai.maggiemi.cn/api/send.php"
API_KEY="你的密钥"

curl -s -X POST "$API_URL" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $API_KEY" \
  -d '{
    "to": "someone@example.com",
    "subject": "每日报表",
    "body": "<p>今日数据已生成</p>"
  }'