获取邮件文件夹列表

POST

/v1/message/folder/list

实时从远端邮箱服务器读取文件夹列表。后续 message 接口优先使用这里返回的 path 作为 folder_path 参数。

请求参数

Body 参数multipart/form-data必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'http://localhost:18321/v1/message/folder/list' \
--form 'token=""' \
--form 'mail_id="mail_demo_001"'

返回响应

🟢200

application/json

成功

Body

示例

{
    "code": 200,
    "msg": "ok",
    "data": {
        "list": [
            {
                "folder_id": "user_demo_001_mail_demo_001_INBOX",
                "mail_id": "mail_demo_001",
                "user_id": "user_demo_001",
                "name": "INBOX",
                "path": "INBOX",
                "type": "inbox",
                "is_system": 1,
                "is_aggregate": -1,
                "unread_count": 12,
                "total_count": 200,
                "remote_folder_id": "INBOX",
                "folder_kind": "inbox"
            },
            {
                "folder_id": "user_demo_001_mail_demo_001_ttt",
                "mail_id": "mail_demo_001",
                "user_id": "user_demo_001",
                "name": "ttt",
                "path": "ttt",
                "type": "folder",
                "is_system": -1,
                "is_aggregate": -1,
                "unread_count": 0,
                "total_count": 0,
                "remote_folder_id": "ttt",
                "folder_kind": "custom"
            }
        ]
    }
}

修改于 2026-04-10 06:30:05

删除代理

获取邮件列表