信件和对话

API 0.16.0OpenAPIllms-full.txt

列表和页面

GET /v1/mailboxes/{mailbox_id}/folders 返回字母总数为 total、未读字母数为 unread 且值为 uidvalidity. 的文件夹。对于字母列表，请使用 GET /v1/mailboxes/{mailbox_id}/messages:，响应包含 items、next_before 和 uidvalidity，每页最多 40 个字母。

在下一个请求中将 next_before 作为 before 传递。 null 表示列表末尾。 q 的搜索限制为 200 个字符，并且根据邮件内容进行。

GET /v1/mailboxes/42/messages?folder=INBOX
GET /v1/mailboxes/42/messages?folder=INBOX&before=120

字母 ID

uid 是文件夹内信件的标识符，folder 是文件夹的名称，mailbox_id 是邮箱的 ID。值 uidvalidity 确定文件夹中字母的编号版本。从答案 API 中取出所有四个值并将它们存储在一起。

如果 uidvalidity 已更改，请重新下载此文件夹的邮件列表：旧的 uid 无法再使用。阅读内容并不会将电子邮件标记为已读。要标记，请执行 POST /v1/mailboxes/{mailbox_id}/messages/actions 和 action=read.

POST /v1/mailboxes/42/messages/actions

{"folder":"INBOX","uidvalidity":123456,"uids":[120],"action":"read"}

通信作为对话

GET /v1/mailboxes/{mailbox_id}/threads 最多返回 100 个对话框。将所选对话的 thread_id 传递给 GET /v1/mailboxes/{mailbox_id}/threads/{thread_id} 以将其字母从旧到新。

对话中可能会稍有延迟地出现新字母。更新列表；要检查提交情况，请使用操作状态。无需因显示延迟而重新发送电子邮件。