API 文档
搜索文档…
获取指定用户的访问明细
使用此功能前需要开通用户明细、用户管理功能,同时还需要做第三方登录定制或进行微信服务号授权

接口

获取指定用户的访问明细
1
GET /api/v3/agent/:id/user/:userId/stats/visits
Copied!

授权

请求 header
1
Authorization: Bearer <accessToken>
2
Content-Type: application/json
Copied!
注:请将上方的 <accessToken> 替换为分配给您的秘钥串。关于如何获取 accessToken ,请咨询杨经理(18968187008)。

参数

参数
类型
参数位置
描述
是否必传
id
int
url path
客户唯一标识
userId
int
url path
用户唯一标识
activityId
string
url query
活动唯一标识
page
int
url query
当前页, 默认为 1
pageSize
int
url query
每页返回个数,默认为 10,最大为 1000
order
enum<visitAt asc, visitAt desc>
url query
排序方式, 默认为 visitAt desc

请求样例

1
curl 'shangzhibo.tv/api/v3/agent/105131/user/15460259/stats/visits?page=1&pageSize=10' \
2
-H 'authorization: bearer <accessToken>'
Copied!

响应

参数
类型
描述
pager
object
分页信息
pager.page
integer
当前页
pager.pageSize
integer
每页返回个数
pager.total
integer
总个数
visitAt
string
访问时间
type
string
观看内容类型, none 无 live 直播 video 视频 playback 回看 unknown 未知
promoteSign
string
推广渠道唯一标识
promoteName
string
推广渠道名称,默认为未知
lastOnlineAt
string
最后在线时间
duration
integer
在线时长 (lastOnlineAt - visitAt), 单位分钟
userId
integer
用户 ID
activityId
string
活动 ID
activity
object
活动信息
activity.id
string
活动 ID
activity.name
string
活动名称
activity.status
string
活动状态,enabled 允许推流 disabled 禁止推流 forbidden 管理员禁止推流
activity.agentId
integer
账号 ID
activity.startedAt
string
活动开始时间
activity.endedAt
string
活动结束时间
activity.pushDomain
string
推流域名
activity.pullDomain
string
拉流域名
activity.isPushing
boolean
是否在推流
activity.createdAt
string
活动创建时间
activity.groupId
integer
活动分组 ID
activity.updateAt
string
活动更新时间
1
{
2
"pager":{
3
"page":1,
4
"pageSize":10,
5
"total":2
6
},
7
"items":[{
8
"activity":{
9
"isArchived":false,
10
"isPushing":false,
11
"id":"10096289",
12
"agentId":105131,
13
"subagentId":null,
14
"name":"这是一场直播",
15
"status":"disabled",
16
"startedAt":"2020-06-24T00:00:00.000Z",
17
"endedAt":"2020-06-24T05:36:51.878Z",
18
"pushDomain":"push.shangzhibo.tv",
19
"pullDomain":"play.shangzhibo.tv",
20
"groupId":-1,
21
"createdAt":"2020-06-22T03:06:29.000Z",
22
"updatedAt":"2020-06-24T05:37:26.322Z"
23
},
24
"visitAt":"2020-06-24T04:28:02.000Z",
25
"lastOnlineAt":"2020-06-24T04:28:05.000Z",
26
"duration":0,
27
"userId":15460259,
28
"activityId":"10096289",
29
"type":"video",
30
"promoteSign": "hGyAXgwnz7_lcR",
31
"type": "测试",
32
}, {
33
"activity":{
34
"isArchived":false,
35
"isPushing":false,
36
"id":"10096289",
37
"agentId":105131,
38
"subagentId":null,
39
"name":"这是一场直播",
40
"status":"disabled",
41
"startedAt":"2020-06-24T00:00:00.000Z",
42
"endedAt":"2020-06-24T05:36:51.878Z",
43
"pushDomain":"push.shangzhibo.tv",
44
"pullDomain":"play.shangzhibo.tv",
45
"groupId":-1,
46
"createdAt":"2020-06-22T03:06:29.000Z",
47
"updatedAt":"2020-06-24T05:37:26.322Z"
48
},
49
"visitAt":"2020-06-24T01:40:01.000Z",
50
"lastOnlineAt":"2020-06-24T01:44:04.000Z",
51
"duration":4,
52
"type":"live",
53
"promoteSign": "hGyAXgwnz7_lcR",
54
"type": "测试",
55
"userId":15460259,
56
"activityId":"10096289"
57
}]
58
}
Copied!
最近更新 1mo ago