打開點擊列表

最新更新:2023-08-10

用戶打開或點擊的郵件,此用戶的地址會進入打開點擊列表。

你可以對此列表進行查詢操作。

查詢

URL

https://email.api.engagelab.cc/v1/track_details
          https://email.api.engagelab.cc/v1/track_details

        
此代碼塊在浮窗中顯示

HTTP 請求方法

GET
          GET

        
此代碼塊在浮窗中顯示

Header

Header 類型 是否必需 描述
Authorization string true Basic base64(api_user:api_key)

查詢參數描述

參數 類型 是否必需 描述
time_zone string * 時區,例如:+8,默認 +8
start_date string * 開始日期格式為 yyyy-MM-dd
end_date string * 結束日期格式為 yyyy-MM-dd
email string * 查詢該地址在打開點擊列表中的詳情
track_type string 1 表示打開,2 表示點擊,不傳此參數查詢打開和點擊全部
api_users string 獲取指定API_USER的統計數據,多個API_USER用分開,如:apiUserList=a;b;c
label_ids string 獲取指定標籤的統計數據;多個標籤用分號分隔,例如,label_ids=a;b;c
offset int 查詢位置,取值區間[0-],默認為 0
limit int 查詢個數,取值區間[0-100],默認為 100

請求示例:

curl -X GET -H 'Content-Type: application/json; charset=utf-8' \ -H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' \ 'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3'
          curl -X GET -H 'Content-Type: application/json; charset=utf-8' \
     -H 'Authorization:Basic YXBpX3VzZXI6YXBpX2tleQ==' \
     'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3' 

        
此代碼塊在浮窗中顯示

返回值描述

參數 描述
email 郵件地址
label_id 郵件標籤 ID
track_type 點擊或者打開類型
url 點擊的 URL
api_user API_USER名稱
curr_time 點擊或者打開的發生時間
ip 點擊或者打開的IP
country IP的歸屬國家
province IP的歸屬省份
city IP 的歸屬城市
browser 使用的瀏覽器名稱
device 使用的設備名稱

返回值示例:

{ "result": [ { "email": "opfwefs@gmail.com", "track_type": 1, "api_user": "sendcloud_op**s", "url": "", "curr_time": "2021-06-09 09:49:30", "email_id": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@send.im", "ip": "47.190.78.5", "country": "United States", "province": "Texas", "city": "Southlake", "browser": "google", "device": "" } ], "count": 1, "total": 2 }
          { 
   "result": [
        {
            "email": "opfwefs@gmail.com",
            "track_type": 1,
            "api_user": "sendcloud_op**s",
            "url": "",
            "curr_time": "2021-06-09 09:49:30",
            "email_id": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@send.im",
            "ip": "47.190.78.5",
            "country": "United States",
            "province": "Texas",
            "city": "Southlake",
            "browser": "google",
            "device": ""
        }
    ],
    "count": 1,
    "total": 2
}

        
此代碼塊在浮窗中顯示
在文档中心打开
icon
聯繫銷售