开发文档

了解 SendDash API 的认证方式、请求参数、响应格式和错误处理建议。

快速开始

SendDash 提供简洁的 HTTP API，适合接入服务器脚本、自动化工作流和业务系统通知。

获取 API Key

在控制台创建 API Key 后即可调用接口。请妥善保管密钥，避免在浏览器端代码或公开仓库中暴露。

去获取 API Key

API 接口参考

POST

邮件推送接口

https://api.senddash.app/v1/send

向一个或多个收件人发送邮件。支持纯文本和 HTML 内容。

请求参数（JSON Body）

参数名	类型	必选	描述
to	Array<String>	是	收件人邮箱地址列表。每次请求最多支持 50 个收件人。
subject	String	是	邮件主题。建议控制在 50 个字符以内。
content	String	是	邮件正文内容。
isHtml	Boolean	否	是否将 content 作为 HTML 渲染。默认为 false (纯文本)。

请求示例：cURL

curl -X POST 'https://api.senddash.app/v1/send' \
-H 'Authorization: Bearer 您的_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "to": ["user@example.com"],
  "subject": "报警通知：服务器负载过高",
  "content": "服务器 node-01 的 CPU 使用率已达到 95%，请立即排查。"
}'

请求示例：Node.js fetch

const response = await fetch('https://api.senddash.app/v1/send', {
method: 'POST',
headers: {
  'Authorization': 'Bearer 您的_API_KEY',
  'Content-Type': 'application/json'
},
body: JSON.stringify({
  to: ['user@example.com'],
  subject: '报警通知：服务器负载过高',
  content: '服务器 node-01 的 CPU 使用率已达到 95%，请立即排查。'
})
});

const result = await response.json();
console.log(result);

成功响应示例

{
"success": true,
"message": "邮件已成功加入发送队列",
"messageId": "msg_1234567890abcdef",
"timestamp": 1713456789
}

错误代码表

请求失败时，接口会返回非 2xx 状态码，并在 JSON 响应体中提供错误信息。

HTTP 状态码	可能原因	处理建议
400 Bad Request	参数缺失、收件人格式错误、收件人数量超限等。	请检查请求的 JSON Body 是否符合文档规范，确保邮箱格式正确。
401 Unauthorized	API Key 缺失、无效或已被重置。	请在 Request Header 中提供正确的 Authorization: Bearer 凭证。
429 Too Many Requests	调用频率过高，触发了限流保护。	请降低请求频率。基础账号建议限制在每秒 1 次请求以内。
500 Internal Error	底层邮件服务商故障或内部处理异常。	请稍后重试。若持续报错，请联系我们获取技术支持。