多用户收件箱 · 登录
账号由管理员创建,暂不开放自助注册。
这些地址收到的邮件都会进入你的收件箱。
支持通配符 *,例如 *@ciallo.store 或 shop-*@ciallo.store。
默认只保留指定厂商的验证码邮件。开启后,发往你地址的所有邮件都会被保留。
用密钥让你的自定义软件读取本收件箱的邮件。
读取:GET /api/v1/inbox?since_id=0&limit=100&include_body=1
单封:GET /api/v1/messages/123 | 身份:GET /api/v1/whoami
认证:请求头 X-API-Key: KEY 或 Authorization: Bearer KEY,也可用 ?key=KEY
开启后,普通用户可在「我的邮箱地址」自行绑定/解绑地址;关闭后地址由管理员统一分配。
用于创建邮箱的收信域名。每个域名可指定一名管理员,各自管理自己的域名。
域名解析需开放端口:25/TCP 收信(MX 指向本机)、80/TCP、443/TCP 门户访问。
记录登录过的设备指纹,可单独拉黑某台设备,阻止其一切登录。
收信、绑定地址、API 接入与安全功能的完整说明。
每个账号有一个收件箱。你的收件地址由系统在注册时自动分配,格式为「固定字段-随机字段」:固定字段取自用户名(可统一加前缀),随机字段为 6 位随机串,例如 alice-7k2m9p@ciallo.store。其来信都会出现在「我的收件箱」。
*@ciallo.store(整域)、shop-*@ciallo.store(前缀)、*(全部)。本服务只接收指定厂商的验证码邮件,其余邮件一律丢弃。识别到的验证码会在收件箱高亮标出,点右上角「只看验证码」可只筛出这类邮件。
在「API 密钥」页生成 mp_... 密钥,请求时用 X-API-Key: 密钥 或 Authorization: Bearer 密钥 携带。
核心约定:拉取 → 处理 → 确认(ack)。邮件被 ack 后删除;未 ack 的保留以便重试。
每条邮件若识别到验证码会带 code 字段;加 only_code=1 只返回含验证码的邮件。
# 1) 增量拉取(since_id 为游标,首次传 0)
GET /api/v1/inbox?since_id=0&limit=100&include_body=1
# 2) 处理成功后确认删除
POST /api/v1/ack {"acks":["ack_xxx","ack_yyy"]}
# 身份确认 / 读取单封
GET /api/v1/whoami
GET /api/v1/messages/123
查询自己的地址(所有密钥可用,只读):
GET /api/v1/aliases # 列出已绑定地址(只读)
增删地址仅限管理员密钥(普通密钥返回 403):
POST /api/v1/aliases {"addresses":["a@ciallo.store"]}
POST /api/v1/aliases/delete {"ids":[12,13]}
管理员密钥额外可用:
POST /api/v1/admin/users {"username":"u","password":"至少6位"}
POST /api/v1/admin/users/<id>/aliases {"addresses":["a@ciallo.store"]}
POST /api/v1/admin/aliases/transfer {"address":"a@ciallo.store","to_user":5}
POST /api/v1/admin/users/<id>/ban {"banned":true}
Python 轮询示例:
import time, requests
BASE, KEY = "https://mail.ciallo.store", "mp_xxxx"
H = {"X-API-Key": KEY}
since = 0
while True:
d = requests.get(f"{BASE}/api/v1/inbox",
params={"since_id": since, "limit": 100, "include_body": 1},
headers=H, timeout=20).json()
acks = []
for m in d["messages"]:
handle(m) # 处理失败就不要 ack,下轮重试
acks.append(m["ack"])
if acks:
requests.post(f"{BASE}/api/v1/ack", json={"acks": acks}, headers=H, timeout=20)
since = d["last_id"]
time.sleep(10)
登录时会记录设备指纹(浏览器特征)。管理员在「用户管理」页可以:
创建用户、重置密码、给指定用户批量加地址、转移地址、封禁用户与设备,都在「用户管理」页完成。
ciallo.store MX 10 mail.ciallo.store。