打开点击列表

用户打开或点击的邮件，此用户的地址会进入打开点击列表.

你可以对此列表进行查询操作.

---

查询

URL

https://api2.sendcloud.net/api/openandclick/list

HTTP请求方式

post    get

参数说明

参数	类型	必须	说明
apiUser	string	是	API_USER
apiKey	string	是	API_KEY
days	int	*	过去 days 天内的统计数据 (days=1表示今天)
startDate	string	*	开始日期, 格式为yyyy-MM-dd
endDate	string	*	结束日期, 格式为yyyy-MM-dd
email	string	*	查询该地址在打开点击列表中的详情
trackType	string	否	1表示打开，2表示点击，不传此参数查询打开和点击全部
apiUserList	string	否	获取指定API_USER的统计数据，多个API_USER用；分开，如:apiUserList=a;b;c
labelId	string	否	获取指定标签下的统计数据
labelName	string	否	获取指定标签名下的统计数据(中文名称以UTF-8编码)
start	int	否	查询起始位置, 取值区间 [0-], 默认为 0
limit	int	否	查询个数, 取值区间 [0-100], 默认为 100

提示:

1. 如果指定时间区间, 则是查询此时间区间内的打开点击数据列表. 注意: startDate 与 endDate 的组合 或者 days 参数, 二者取一.
2. 查询的天数不超过三个月.
3. 如果指定email,不指定时间区间， 默认是查询最近三个月数据。如果需要根据时间区间查询，带上days参数或者startDate 和endDate即可
4. 如果不指定apiUserList，默认查询所有记录.

请求示例:

https://api2.sendcloud.net/api/openandclick/list?apiUser=***&apiKey=***&days=100&start=0&limit=3 

返回值说明

参数	说明
email	邮件地址
trackType	点击或者打开类型
url	点击的url
apiUser	apiUser名称
requestTime	邮件请求成功时间
currTime	点击或者打开的发生时间
emailId	SendCloud 投递一封邮件, 返回的邮件编号, 可以对应到某一次请求的某一个收件人
ip	点击或者打开的ip
country	ip的归属国家
province	ip的归属省份
city	ip的归属城市
browser	使用的浏览器名称
device	使用的移动设备名称

返回值示例:

{
    "result": true,
    "statusCode": 200,
    "message": "request was successful",
    "info": {
        "total": 1,
        "dataList": [
            {
                "trackType": 1,
                "apiUser": "sendcloud_op**s",
                "email": "op**s@sendcloud.im",
                "url": "",
                "currTime": "2021-06-09 09:49:30",
                "emailId": "162320******_143833_116562_2325.sc-10_9_13_213-inbound0$ops@sendcloud.im",
                "requestTime": "2021-06-09 09:01:13",
                "ip": "47.190.78.5",
                "country": "United States",
                "province": "Texas",
                "city": "Southlake",
                "browser": "google",
                "device": ""
            }
        ],
        "count": 1
    }
}

---