发信

发送邮件

POSThttps://api.temporam.com/v3/messages

字段	类型	必填	说明
from	string	是	你拥有的有效邮箱地址
to	string	是	收件人地址
subject	string	是	邮件主题
text	string	否	纯文本正文
html	string	否	HTML 正文
from_name	string	否	发件人显示名
reply_to_message_id	string	否	已认领入站邮件的 UUID

至少提供 text 或 html 之一。该操作不是幂等的，网络超时后不要盲目重试。

1curl -X POST https://api.temporam.com/v3/messages \
2 -H "Authorization: Bearer YOUR_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{"from":"[email protected]","to":"[email protected]","subject":"Hello","text":"Hello from Temporam"}'

1{
2 "data": {
3 "id": "550e8400-e29b-41d4-a716-446655440001",
4 "from": "[email protected]",
5 "to": "[email protected]",
6 "subject": "Hello",
7 "status": "sent",
8 "created_at": "2026-08-13T00:00:00Z"
9 },
10 "meta": {
11 "remaining": 99
12 }
13}

响应字段	类型	说明
data.id	string	发件邮件 UUID
data.from	string	发件地址
data.from_name	string	发件人显示名称，可用时返回
data.to	string	收件地址
data.subject	string	邮件主题
data.status	string	发送状态
data.provider_message_id	string	服务商消息 ID，可用时返回
data.created_at	string	创建时间
data.sent_at	string	发送时间，可用时返回
meta.remaining	integer	剩余发件额度，可用时返回

Hobby 套餐不支持发信；成功发送会消耗一个发信额度。

查询发信详情

GEThttps://api.temporam.com/v3/messages/{id}

参数	位置	类型	必填	说明
id	path	string (UUID)	是	发件邮件 UUID

响应字段	类型	说明
data.id	string	发件邮件 UUID
data.from	string	发件地址
data.to	string	收件地址
data.subject	string	邮件主题
data.status	string	发送状态
data.provider_message_id	string	服务商消息 ID，可用时返回
data.created_at	string	创建时间
data.sent_at	string	发送时间，可用时返回
meta.remaining	integer	剩余发件额度，可用时返回

查询结果不包含 text、html 或 from_name。

1curl https://api.temporam.com/v3/messages/550e8400-e29b-41d4-a716-446655440001 \
2 -H "Authorization: Bearer YOUR_API_KEY"

← 上一页: 收信