全部產品
Search

搜尋本產品

    Direct Mail：SenderStatisticsDetailByParam - 擷取發送詳情

    文件中心

    Direct Mail：SenderStatisticsDetailByParam - 擷取發送詳情

    更新時間：Jan 07, 2026

    擷取發送詳情。

    調試

    您可以在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。

    e42a4d8e-66e0-4ea3-88aa-74c66c661cef
    ConfigSetId

    string

    否

    配置集 ID。

    95437e39-5433-4c6c-8b66-0c4eac2f4d97

    返回參數

    名稱

    類型

    描述

    樣本值

    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"
      }
    ]
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。