1. 邮件接口
ELink邮箱开放平台API接口
  • 邮箱接口
    • 获取邮箱列表
      POST
    • 获取邮箱详细
      POST
    • 同步邮箱配置到本地
      POST
    • 创建邮箱配置
      POST
    • 修改邮箱配置
      POST
    • 删除邮箱配置
      POST
  • 代理接口
    • 获取代理列表
      POST
    • 获取代理详细
      POST
    • 创建代理
      POST
    • 修改代理
      POST
    • 删除代理
      POST
  • 邮件接口
    • 获取邮件文件夹列表
      POST
    • 获取邮件列表
      POST
    • 获取邮件详情
      POST
    • 发送邮件
      POST
    • 标记已读或未读
      POST
    • 移动邮件到目标文件夹
      POST
    • 标记星标或取消星标
      POST
  1. 邮件接口

获取邮件列表

POST
/v1/message/list
实时从远端邮箱服务器读取邮件列表。请求下一页时,把上一页返回的 next_offset 原样作为 offset 传回。keyword 与 subject/body/from/to 互斥。POP 不支持筛选。microsoft_graph 暂不支持把文本筛选和 flagged/seen 组合在同一次请求中。

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://localhost:18321/v1/message/list' \
--form 'token=""' \
--form 'mail_id="mail_demo_001"' \
--form 'folder_path="INBOX"' \
--form 'limit="20"' \
--form 'offset="eyJwYWdlX3Rva2VuIjoiMiJ9"' \
--form 'keyword="invoice"' \
--form 'subject="Verify Code"' \
--form 'body="verification"' \
--form 'from="[email protected]"' \
--form 'to="[email protected]"' \
--form 'flagged="0"' \
--form 'seen="0"'

返回响应

🟢200
application/json
成功
Body

示例
{
    "code": 200,
    "msg": "ok",
    "data": {
        "list": [
            {
                "message_id": "uid:10001",
                "header_message_id": "<[email protected]>",
                "mail_id": "mail_demo_001",
                "folder_id": "user_demo_001_mail_demo_001_INBOX",
                "folder_type": "inbox",
                "subject": "Welcome to the product demo",
                "from": {
                    "name": "Demo Sender",
                    "address": "[email protected]"
                },
                "sender": null,
                "to": [
                    {
                        "name": "Demo User",
                        "address": "de***@example.com"
                    }
                ],
                "cc": [],
                "bcc": [],
                "date": "2026-04-10T09:30:00.000Z",
                "preview_text": "This is a masked preview for API documentation.",
                "is_read": -1,
                "is_flagged": -1,
                "is_important": -1,
                "has_attachment": -1,
                "message_detail_download_status": 1,
                "size": 0,
                "in_reply_to": "",
                "references": [],
                "receive_protocol_type": "imap",
                "remote_thread_id": "",
                "provider_meta": {
                    "uid": 10001,
                    "sequenceId": 1501,
                    "threadSequenceText": null,
                    "threadSequenceIsUid": null
                }
            }
        ],
        "has_more": 1,
        "next_offset": "eyJwYWdlX3Rva2VuIjoiMiJ9",
        "total_count": 1501
    }
}
修改于 2026-04-10 06:30:05
上一页
获取邮件文件夹列表
下一页
获取邮件详情
Built with