> For the complete documentation index, see [llms.txt](https://shangzhibo.gitbook.io/api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://shangzhibo.gitbook.io/api/ke-hu-wang-zhan-shou-quan-deng-lu/get-user-visits.md).

# 获取指定用户的访问明细

## 接口

获取指定用户的访问明细

```javascript
GET /api/v3/agent/:id/user/:userId/stats/visits
```

## 授权

请求 header

```http
Authorization: Bearer <accessToken>
Content-Type: application/json
```

注：请将上方的 `<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 | 否    |

### 请求样例

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

## 响应

| 参数                  | 类型      | 描述                                                     |
| ------------------- | ------- | ------------------------------------------------------ |
| 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  | 活动更新时间                                                 |

```javascript
{
    "pager":{
        "page":1,
        "pageSize":10,
        "total":2
    },
    "items":[{
            "activity":{
                "isArchived":false,
                "isPushing":false,
                "id":"10096289",
                "agentId":105131,
                "subagentId":null,
                "name":"这是一场直播",
                "status":"disabled",
                "startedAt":"2020-06-24T00:00:00.000Z",
                "endedAt":"2020-06-24T05:36:51.878Z",
                "pushDomain":"push.shangzhibo.tv",
                "pullDomain":"play.shangzhibo.tv",
                "groupId":-1,
                "createdAt":"2020-06-22T03:06:29.000Z",
                "updatedAt":"2020-06-24T05:37:26.322Z"
            },
            "visitAt":"2020-06-24T04:28:02.000Z",
            "lastOnlineAt":"2020-06-24T04:28:05.000Z",
            "duration":0,
            "userId":15460259,
            "activityId":"10096289",
            "type":"video",
            "promoteSign": "hGyAXgwnz7_lcR",
            "type": "测试",
        }, {
            "activity":{
                "isArchived":false,
                "isPushing":false,
                "id":"10096289",
                "agentId":105131,
                "subagentId":null,
                "name":"这是一场直播",
                "status":"disabled",
                "startedAt":"2020-06-24T00:00:00.000Z",
                "endedAt":"2020-06-24T05:36:51.878Z",
                "pushDomain":"push.shangzhibo.tv",
                "pullDomain":"play.shangzhibo.tv",
                "groupId":-1,
                "createdAt":"2020-06-22T03:06:29.000Z",
                "updatedAt":"2020-06-24T05:37:26.322Z"
            },
            "visitAt":"2020-06-24T01:40:01.000Z",
            "lastOnlineAt":"2020-06-24T01:44:04.000Z",
            "duration":4,
            "type":"live",
            "promoteSign": "hGyAXgwnz7_lcR",
            "type": "测试",
            "userId":15460259,
            "activityId":"10096289"
        }]
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shangzhibo.gitbook.io/api/ke-hu-wang-zhan-shou-quan-deng-lu/get-user-visits.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.