事务性邮件统计

概述

获取指定日期范围内的事务性邮件统计。结果按每日明细返回,涵盖投递、互动、退信和退订指标。 基础 URL: https://api.effilink.co 端点: POST /v5/transactional/mail/stats/get 认证方式: 在请求header中添加ApiKey来进行认证

请求参数

string

必填

查询日期范围的起始日期,格式为 YYYY-MM-DD。此日期包含在内。示例:"2025-05-01"

string

必填

查询日期范围的结束日期,格式为 YYYY-MM-DD。此日期包含在内。示例:"2025-05-31"

响应字段

int

成功时为 200。非 200 值表示错误。

string

成功时为 null。失败时包含错误描述。

array[object]

覆盖请求日期范围的每日统计对象数组。每个对象代表一个日历日。

显示 mailStatsList[] 字段

string

此条目的日历日期,格式为 YYYY-MM-DD。

int

此日期成功发送的邮件总数。

int

已被收件人打开的已发送邮件数。需要在发送时启用打开跟踪。

int

所有已发送邮件中记录的链接点击次数。需要在发送时启用点击跟踪。

int

记录的软退信数量,即临时无法投递的邮件。

int

被过滤或抑制且未投递的邮件数量(例如由于退订列表或地址无效)。

int

此日期通过邮件退订链接退订的收件人数。

示例

请求

curl --request POST \
  --url https://api.effilink.co/v5/transactional/mail/stats/get \
  --header 'Content-Type: application/json' \
  --header 'ApiKey: YOUR_API_KEY' \
  --data '{
    "startDate": "2025-05-01",
    "endDate": "2025-05-31"
  }'

响应

{
  "code": 200,
  "message": null,
  "mailStatsList": [
    {
      "statsDate": "2025-05-01",
      "sentCount": 450,
      "openCount": 120,
      "clickCount": 38,
      "bounceCount": 2,
      "unsentCount": 0,
      "unsubscribeCount": 1
    },
    {
      "statsDate": "2025-05-02",
      "sentCount": 510,
      "openCount": 155,
      "clickCount": 44,
      "bounceCount": 0,
      "unsentCount": 1,
      "unsubscribeCount": 2
    }
  ]
}