通知系统使用指南

curl -X POST "https://your-domain.com/send.php" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "subject": "订单状态更新",
    "message": "订单 A1001 已支付成功",
    "order_id": "A1001",
    "server": "web-01"
  }'

<?php
$url = 'https://your-domain.com/send.php';
$payload = [
    'subject' => '订单状态更新',
    'message' => '订单 A1001 已支付成功',
    'order_id' => 'A1001',
    'server' => 'web-01',
];

$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_KEY',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload, JSON_UNESCAPED_UNICODE));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

url = "https://your-domain.com/send.php"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY",
}
payload = {
    "subject": "订单状态更新",
    "message": "订单 A1001 已支付成功",
    "order_id": "A1001",
    "server": "web-01",
}

response = requests.post(url, json=payload, headers=headers, timeout=15)
print(response.status_code)
print(response.text)

const payload = {
  subject: "订单状态更新",
  message: "订单 A1001 已支付成功",
  order_id: "A1001",
  server: "web-01"
};

fetch("https://your-domain.com/send.php", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_API_KEY"
  },
  body: JSON.stringify(payload)
})
  .then((response) => response.text())
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

接口统一返回 JSON。接入时建议同时判断 HTTP 状态码和 success 字段，再决定是否提示失败、记录日志或稍后重试。

200 OK
{
  "success": true,
  "message": "发送成功",
  "user": "demo",
  "sender_mode": "official"
}

如果账号开启了调试模式，并且调试查看器在线，接口会返回调试结果而不是实际发信：

200 OK
{
  "success": true,
  "debug": true,
  "message": "debug",
  "user": "demo"
}

常见失败返回示例：

400 Bad Request
{
  "success": false,
  "error": "缺少 API Key"
}

403 Forbidden
{
  "success": false,
  "error": "API Key 无效"
}

429 Too Many Requests
{
  "success": false,
  "error": "发送过于频繁或已达到今日上限"
}

500 Internal Server Error
{
  "success": false,
  "error": "SMTP 配置或发送过程出错"
}

• 200 表示系统已成功接收请求；若同时出现 debug: true，说明请求进入调试模式，未真正发送邮件。
• 400 通常是缺少身份字段，优先检查 Bearer Token 或请求体里的 key。
• 403 表示 API Key 校验失败，常见原因是填错、复制不完整或凭证已失效。
• 429 表示触发发送频率限制或当日额度限制，适合延迟后重试。
• 500 表示服务端发送阶段失败，通常需要检查 SMTP 配置、授权码或邮箱服务状态。