SenderStatisticsDetailByParam - 获取发送详情_邮件推送(Direct Mail)-阿里云帮助中心

获取发送详情。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dm:SenderStatisticsDetailByParam

list

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
AccountName	string	否	发信地址。不填，代表所有地址。说明 AccountName、TagName、ToAddress 可以都不填写。若填写，只能传递其中一个参数，不能同时传递两个或以上组合的参数。	s***@example.net
ToAddress	string	否	收信地址。不填，代表所有收信地址。	b***@example.net
Status	integer	否	投递结果。不填，代表所有状态。取值： 0：成功 2：无效地址 3：垃圾邮件 4：失败	0
StartTime	string	否	起始时间，和结束时间跨度不能超出 30 天，格式 yyyy-MM-dd HH:mm	2021-04-28 00:00
EndTime	string	否	结束时间，和起始时间跨度不能超出 30 天, 格式 yyyy-MM-dd HH:mm。	2021-04-29 00:00
TagName	string	否	邮件标签。不填，代表所有标签。 SMTP 发信时，请参考邮件跟踪示例，对“X-AliDM-Trace”字段，指定标签字段"TagName"和对应值。	EmailQuestionnaireHelioscam
Length	integer	否	指定本次请求返回结果数目。范围是 1~100	5
NextStart	string	否	分页用，指定本次请求的偏移量。如果还有更多结果，下次请求将该返回值设置到请求中的 NextStart	90f0243616#203#a*@example.net-1658817837#a*@example.net.247475288187
IpPoolId	string	否	独立 IP 地址池 ID。	xxx
ConfigSetId	string	否	配置集 ID。	xxx

返回参数

名称	类型	描述	示例值
	object
NextStart	string	分页使用。如果还有更多结果，下次请求将该返回值设置到请求中的 NextStart	90f0243616#203#a*@example.net-1658817689#a*@example.net.247141122178
RequestId	string	请求 ID	B5AB8EBB-EE64-4BB2-B085-B92CC5DEDC41
data	object
mailDetail	array<object>	详细记录
	object
Status	integer	投递状态：0 成功，2 无效地址，3 垃圾邮件，4 其余失败	0
LastUpdateTime	string	更新时间	2021-04-28T17:11Z
Message	string	投递详情信息	250 Send Mail OK
ToAddress	string	收信地址	b***@example.net
UtcLastUpdateTime	string	UTC 格式的更新时间	1619601108
AccountName	string	发信地址	s***@example.net
Subject	string	邮件主题	test subject
ErrorClassification	string	错误原因的详细分类： SendOk：投递成功 SmtpNxBox：收信系统认定为无效地址，会进入您的账号级别无效地址库。 SysOutRcptOnAccountLevelBounceList：命中账号级别无效地址库，如您确认该地址有效，可在无效地址库页面进行删除，或选择不启用账号级别无效地址库。更多错误描述请参考关于常见 failed_type 的解释	SendOk
IpPoolId	string	独立 IP 地址池 ID。	xxx
IpPoolName	string	独立 IP 地址池名称。	xxx
ConfigSetId	string	配置集 ID。	xxx
ConfigSetName	string	配置集名称。	xxx

示例

正常返回示例

JSON格式

{
  "NextStart": "90f0243616#203#a***@example.net-1658817689#a***@example.net.247141122178",
  "RequestId": "B5AB8EBB-EE64-4BB2-B085-B92CC5DEDC41",
  "data": {
    "mailDetail": [
      {
        "Status": 0,
        "LastUpdateTime": "2021-04-28T17:11Z",
        "Message": "250 Send Mail OK",
        "ToAddress": "b***@example.net",
        "UtcLastUpdateTime": "1619601108",
        "AccountName": "s***@example.net",
        "Subject": "test subject",
        "ErrorClassification": "SendOk",
        "IpPoolId": "xxx",
        "IpPoolName": "xxx",
        "ConfigSetId": "xxx",
        "ConfigSetName": "xxx"
      }
    ]
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。