收信

列出邮件

GEThttps://api.temporam.com/v3/emails

参数	类型	默认值	说明
email	string	—	要查询的邮箱地址
page	integer	`1`	页码
limit	integer	`20`	每页数量

1curl "https://api.temporam.com/v3/emails?email=demo%40temporam.com&page=1&limit=20" \
2 -H "Authorization: Bearer YOUR_API_KEY"

列表项包含 id、uuid、发件人、收件人、主题、摘要和时间，不含完整正文。

1{
2 "data": [
3 {
4 "id": "550e8400-e29b-41d4-a716-446655440000",
5 "uuid": "550e8400-e29b-41d4-a716-446655440000",
6 "from_email": "[email protected]",
7 "to_email": "[email protected]",
8 "subject": "Verification code",
9 "summary": "Your code is 123456",
10 "created_at": "2026-08-13T00:00:00Z",
11 "from_name": "Sender",
12 "to_name": "Demo",
13 "from_domain": "example.com",
14 "to_domain": "temporam.com"
15 }
16 ],
17 "meta": {
18 "total": 1,
19 "page": 1,
20 "limit": 20,
21 "remaining": 99
22 }
23}

响应字段	类型	说明
data	array	收件邮件列表
data[].id	string	邮件 UUID
data[].uuid	string	邮件 UUID
data[].created_at	string	收件时间
data[].from_name	string	发件人显示名称，可用时返回
data[].from_email	string	发件人邮箱地址
data[].to_name	string	收件人显示名称，可用时返回
data[].to_email	string	收件人邮箱地址
data[].subject	string	邮件主题
data[].summary	string	正文摘要
data[].from_domain	string	发件域名，可用时返回
data[].to_domain	string	收件域名，可用时返回
meta.total	integer	符合条件的邮件总数
meta.page	integer	当前页码
meta.limit	integer	每页数量
meta.remaining	integer	剩余收件额度，可用时返回

读取最新邮件

GEThttps://api.temporam.com/v3/emails/latest

参数	位置	类型	必填	说明
email	query	string	是	要查询的邮箱地址

响应字段	类型	说明
data	object	最新一封邮件，包含上表所列邮件字段
data.content	string	完整邮件正文
meta.remaining	integer	剩余收件额度，可用时返回

1curl "https://api.temporam.com/v3/emails/latest?email=demo%40temporam.com" \
2 -H "Authorization: Bearer YOUR_API_KEY"

查询邮件详情

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

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

响应字段	类型	说明
data	object	邮件详情，包含上表所列邮件字段
data.content	string	完整邮件正文
meta.remaining	integer	剩余收件额度，可用时返回

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

读取未认领邮件或完整内容可能影响入站额度；自动化程序应先用列表接口筛选，再按需读取详情。

← 上一页: 邮箱下一页: 发信 →