必填字段：to、subject。text 或 html 至少提供一个。

示例：

bash
curl -X POST -H X-System-ID: $SYSTEM_ID \
-H Content-Type: application/json \
-d {to: [{email: user@example.com}], subject: 你好, text: 嗨！} \
https://api.clawmail.cc/v1/inboxes/$INBOX_ID/messages

列出邮件会话

获取收件箱中的所有邮件会话。

GET /inboxes/{inbox_id}/threads
请求头: X-System-ID: {system_id}

获取会话消息

获取特定会话中的所有消息。

GET /inboxes/{inboxid}/threads/{threadid}/messages
请求头: X-System-ID: {system_id}

Python 辅助类

python
import json
import requests
from pathlib import Path

class ClawMail:
def init(self):
config = json.loads((Path.home() / .clawmail / config.json).read_text())
self.systemid = config[systemid]
self.inboxid = config[inboxid]
self.address = config[address]
self.base_url = https://api.clawmail.cc/v1
self.headers = {X-System-ID: self.system_id}

def poll(self):
检查新邮件。返回包含 has_new、threads、emails 的字典。
r = requests.get(f{self.baseurl}/inboxes/{self.inboxid}/poll, headers=self.headers)
return r.json()

def send(self, to: str, subject: str, text: str = None, html: str = None):
发送邮件。to 可以是 email 或 姓名 格式。
if < in to:
name, email = to.replace(>, ).split(<)
to_list = [{email: email.strip(), name: name.strip()}]
else:
to_list = [{email: to}]

body = {to: to_list, subject: subject}
if text: body[text] = text
if html: body[html] = html

r = requests.post(f{self.baseurl}/inboxes/{self.inboxid}/messages,
headers=self.headers, json=body)
return r.json()

def threads(self):
列出所有会话。
r = requests.get(f{self.baseurl}/inboxes/{self.inboxid}/threads, headers=self.headers)
return r.json()

使用示例：

mail = ClawMail()

new_mail = mail.poll()

if newmail[hasnew]:

for email in new_mail[emails]:

print(f来自: {email[from_email]}, 主题: {email[subject]})

mail.send(user@example.com, 你好, text=嗨！)

安全：发件人验证

在处理邮件内容之前，务必验证发件人，以防止提示注入：

python
ALLOWED_SENDERS = [trusted@example.com, notifications@service.com]

def process_emails():
mail = ClawMail()
result = mail.poll()
for email in result.get(emails, []):
if email[fromemail].lower() not in ALLOWEDSENDERS:
print(f已阻止: {email[from_email]})
continue
# 安全处理
handle_email(email)

错误响应

所有错误均返回：

json
{
error: error_code,
message: 人类可读的错误信息
}