获取邮件列表 - 脆球邮箱-API接口文档

本接口旗舰版请求请使用独立服务器地址，参考文档：https://docs.cuiqiu.com/docs/domain-email/%E6%93%8D%E4%BD%9C%E6%8C%87%E5%8D%97/%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0%E6%8E%A5%E5%8F%A3%E6%96%87%E6%A1%A3#api%E8%AF%B7%E6%B1%82%E5%9C%B0%E5%9D%80

请求参数

Body 参数multipart/form-data

token

string

必需

后台生成的token

示例值:

folder

array[string]

必需

邮箱文件夹，可以通过/v1/message/folder/list接口获取。如：Inbox，备注：Inbox:收件箱 Drafts:草稿箱 Sent:发件箱 Deleted Items:已删除邮件

示例值:

["Inbox"]

mail_id

string

必需

邮箱ID(可在脆球后台获取，或者通过/v1/mail/list接口获取，id字段即为mail_id)

示例值:

12345678

start_time

string

必需

开始时间，如：2015-05-20

示例值:

2024-05-01

end_time

string

必需

结束时间，如：2015-05-20。特别注意：接口时间选择维度是天，如选择当天，请将日期加一处理，如：end_time设置2021-05-01，代表2021-05-01 00:00:00，如需请求2021-05-01的数据，请设置为2021-05-02

示例值:

2025-03-24

page

integer

页码

必需

示例值:

limit

integer

必需

每页返回条数，最大为20

示例值:

from

string

可选

发送邮箱，如：from@mail.com

示例值:

from@mail.com

string

可选

接收邮箱，适合代收功能使用，如：to@mail.com

示例值:

to@mail.com

subject

string

根据标题筛选

可选

示例值:

标题

flagged

integer

可选

星标，1星标邮件 -1未星标邮件 0全部

示例值:

seen

integer

可选

阅读，1已读 -1未读 0全部

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

必需

msg

string

必需

data

object

必需

list

array [object {6}]

必需

total

integer

必需

示例

{
  "code": 0,
  "msg": "string",
  "data": {
    "list": [
      {
        "from": "string",
        "id": "string",
        "subject": "string",
        "time": "string",
        "timestamp": 0,
        "to": "string"
      }
    ],
    "total": 0
  }
}