邮箱
创建邮箱
POSThttps://api.temporam.com/v3/mailboxes
| 字段 | 类型 | 必填 | 说明 |
|---|
| domain | string | 是 | 从域名接口取得的域名 |
| local_part | string | 否 | 邮箱前缀；省略时由服务端生成 |
- 1curl -X POST https://api.temporam.com/v3/mailboxes \
- 2 -H "Authorization: Bearer YOUR_API_KEY" \
- 3 -H "Content-Type: application/json" \
- 4 -d '{"domain":"temporam.com","local_part":"demo"}'
- 1{
- 2 "data": {
- 3 "id": "123",
- 4 "address": "[email protected]",
- 5 "local_part": "demo",
- 6 "domain": "temporam.com",
- 7 "status": "active",
- 8 "created_at": "2026-08-13T00:00:00Z"
- 9 },
- 10 "meta": {
- 11 "remaining": 100
- 12 }
- 13}
| 响应字段 | 类型 | 说明 |
|---|
| data.id | string | 邮箱 ID |
| data.address | string | 完整邮箱地址 |
| data.local_part | string | 邮箱前缀 |
| data.domain | string | 邮箱域名 |
| data.status | string | 邮箱状态 |
| data.created_at | string | 创建时间 |
| meta.remaining | integer | 相关剩余额度，可用时返回 |
列出邮箱
GEThttps://api.temporam.com/v3/mailboxes
| 参数 | 类型 | 默认值 | 说明 |
|---|
| page | integer | 1 | 页码 |
| limit | integer | 20 | 每页数量 |
- 1curl "https://api.temporam.com/v3/mailboxes?page=1&limit=20" -H "Authorization: Bearer YOUR_API_KEY"
| 响应字段 | 类型 | 说明 |
|---|
| data | array | 邮箱列表，单项字段同上表 |
| meta.total | integer | 邮箱总数 |
| meta.page | integer | 当前页码 |
| meta.limit | integer | 每页数量 |
| meta.remaining | integer | 相关剩余额度，可用时返回 |
查询邮箱
GEThttps://api.temporam.com/v3/mailboxes/{id}
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|
| id | path | string | 是 | 邮箱 ID |
| 响应字段 | 类型 | 说明 |
|---|
| data | object | 邮箱详情，字段同上表 |
| meta.remaining | integer | 相关剩余额度，可用时返回 |
删除邮箱
DELETEhttps://api.temporam.com/v3/mailboxes/{id}
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|
| id | path | string | 是 | 邮箱 ID |
| 响应字段 | 类型 | 说明 |
|---|
| data.deleted | boolean | 删除成功时固定为 true |
| meta.remaining | integer | 相关剩余额度，可用时返回 |
删除后不能再将该邮箱用作发件人。
- 1curl -X DELETE https://api.temporam.com/v3/mailboxes/123 -H "Authorization: Bearer YOUR_API_KEY"