AppPush
WebPush
WhatsApp
Email
SMS
OTP
打開點擊列表
最新更新：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 |
| 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: 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: YXBpX3VzZXI6YXBpX2tleQ==' \
'https://email.api.engagelab.cc/v1/track-details?offset=0&limit=3'
此代碼塊在浮窗中顯示
返回值描述
| 參數 | 描述 |
|---|---|
| 郵件地址 | |
| 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
}
此代碼塊在浮窗中顯示
