垃圾邮件 - 临时收件箱技能

即时创建一次性电子邮件地址。适用于注册、测试和保护隐私。

何时使用此技能

当用户需要时使用此技能：

• 创建临时/一次性电子邮件地址
• 在不使用真实邮箱的情况下注册服务
• 测试邮件发送功能
• 等待验证或确认邮件
• 从邮件中提取验证码或链接

重要：令牌管理

创建收件箱时，您会收到一个令牌。所有后续操作都需要此令牌。请务必为同一收件箱会话存储并重复使用此令牌。

API 参考

基础 URL：https://shitty.email

创建新收件箱

curl -s -X POST https://shitty.email/api/inbox | jq

响应：

{
  "email": "abc1234@shitty.email",
  "token": "a1b2c3d4e5f6..."
}

请同时存储电子邮件地址和令牌- 所有其他操作都需要此令牌。

检查收件箱邮件

curl -s -H "X-Session-Token: {token}" https://shitty.email/api/inbox | jq

响应：

{
  "emails": [
    {
      "id": "msg_a1b2c3d4e5",
      "from": "sender@example.com",
      "subject": "Welcome!",
      "date": "2026-02-03T12:00:00Z"
    }
  ]
}

获取完整邮件内容

使用id字段（来自收件箱响应，例如msg_a1b2c3d4e5）。请注意，这并非电子邮件地址。

curl -s -H "X-Session-Token: {token}" https://shitty.email/api/email/{email_id} | jq

响应包含html和text字段，其中包含邮件正文。

延长收件箱生命周期

收件箱默认在1小时后过期。可延长1小时（总时长最多24小时）：

curl -s -X POST -H "X-Session-Token: {token}" https://shitty.email/api/inbox/extend | jq

删除收件箱

使用完毕后请及时清理：

curl -s -X DELETE -H "X-Session-Token: {token}" https://shitty.email/api/inbox

常见工作流程

等待验证邮件

轮询收件箱直至收到符合条件的邮件：

# Create inbox
RESPONSE=$(curl -s -X POST https://shitty.email/api/inbox)
EMAIL=$(echo $RESPONSE | jq -r '.email')
{token}=$(echo $RESPONSE | jq -r '.token')

# Poll for emails (check every 5 seconds, max 60 seconds)
for i in {1..12}; do
  EMAILS=$(curl -s -H "X-Session-Token: ${token}" https://shitty.email/api/inbox)
  COUNT=$(echo $EMAILS | jq '.emails | length')
  if [ "$COUNT" -gt "0" ]; then
    echo "Email received!"
    echo $EMAILS | jq '.emails[0]'
    break
  fi
  sleep 5
done

提取验证码

收到邮件后，提取常见的验证码模式：

# Get email content
CONTENT=$(curl -s -H "X-Session-Token: ${token}" https://shitty.email/api/email/${email_id} | jq -r '.text')

# Common patterns to look for:
# - 6-digit codes: grep -oE '[0-9]{6}'
# - Verification links: grep -oE 'https?://[^ ]+verify[^ ]*'

最佳实践

1. 重复使用令牌- 非必要不创建新收件箱
2. 负责任地轮询- 每次检查间隔5秒
3. 及时清理- 使用完毕后删除收件箱以释放资源
4. 按需延期- 如需等待延迟邮件，可延长收件箱有效期

使用限制

• 收件箱1小时后过期（最长可延长至24小时）
• 邮件大小限制：1MB
• 频率限制：请勿滥用收件箱创建功能
• 仅接收邮件 - 不支持外发邮件

对话示例

用户：“帮我创建临时邮箱” → 调用POST /api/inbox接口，返回邮箱地址并存储令牌

用户：“帮我注册newsletter.example.com” → 使用临时邮箱填写注册表单，随后轮询确认邮件

用户：“我收到确认邮件了吗？” → 使用存储的令牌检查收件箱并反馈结果

用户：“验证码是多少？” → 获取邮件内容，提取验证码模式并返回

用户："我完成了，删除收件箱" → 调用DELETE /api/inbox 并携带令牌