获取模型当日访问记录

接口说明：

根据请求所携带 token 关联的公司（app_id 所属公司）+ 指定模型 + 指定日期，分页返回该模型当日（北京时间）的所有访问记录（PV）。

服务端在查询时会自动按公司隔离，禁止跨公司查询其他公司的模型数据；如果传入的 model_id 不属于该公司，将返回空记录。

请求路径：

{HostName}/api/v2/op/statistics/records/

请求方式：

• GET

Headers：

{
  "Authorization": "gAAAAABhG3g4Fd2NiMHocf8r-PVZCp1Xku3Rn1brr5wMPQNqkpqV8HrvZDfeYtdGdQrN_eTWaRvr1V5lPMda_kLaJvuYOyUruVWZJ6EH84WWu7sK51zxZibSUO4Huhzv9lGeDQg9ITeZ88JXg1ddG-kRdXIY7Qkic6XSXFXpA4lPNUtLB-pkEOM="
}

CURL 示例

curl --location 'https://opendev.3dnest.cn/api/v2/op/statistics/records/?date=2026-05-25&model_id=M12345&page=1&page_size=100' \
--header 'Authorization: gAAAAABkgu0BIdMLD1NaKTcvEkc52JGhufhNfm0SpW1Rft5whoeFM9FWXDVK-ceDc5kbXaQjjoVgst5W-g7I4GUgQXH_0Imcd3z78Isjye3pFcmldydxtSxuBdY6TTQ3zsgqX5vzytzgawTI0Zvuse5FyBcL6ZJWt4P6UbCnhE6UoPFiHP8lphXBXQ6n34euuWffhj1gaOps'

请求参数字段及含义:

字段名	类型	是否必传	含义
date	string	是	查询日期，北京时间，格式 yyyy-MM-dd，例如 2026-05-25
model_id	string	是	模型 id
page	int	否	页码，从 1 开始，默认 1
page_size	int	否	每页条数，默认 100，最大 1000

响应参数示例

{
  "msg": "success",
  "code": 1,
  "data": {
    "date": "2026-05-25",
    "model_id": "M12345",
    "company_id": 131,
    "page": 1,
    "page_size": 100,
    "total": 87,
    "records": [
      {
        "pv_uuid": "pv-xxx-001",
        "user_uuid": "u-aaa-001",
        "model_id": "M12345",
        "create_time": "2026-05-25 09:12:33",
        "scan_time": 245,
        "customer_uid": ""
      },
      {
        "pv_uuid": "pv-xxx-002",
        "user_uuid": "u-aaa-002",
        "model_id": "M12345",
        "create_time": "2026-05-25 09:05:11",
        "scan_time": 60,
        "customer_uid": "ext_user_001"
      }
    ]
  }
}

响应参数字段及含义:

字段名	类型	是否必传	含义
msg	string	是	响应状态描述
code	int	是	响应状态码
data	object	是	响应数据

data 对象字段及含义:

字段名	类型	是否必传	含义
date	string	是	查询日期（同入参 date）
model_id	string	是	模型 id（同入参 model_id）
company_id	int	是	众趣公司 id（由 token 自动关联，不可由前端指定）
page	int	是	当前页码
page_size	int	是	每页条数
total	int	是	命中总条数（即该模型当日的 PV 总数）
records	list	是	当前页的访问记录列表，按访问时间倒序排列

records 列表元素字段及含义:

字段名	类型	是否必传	含义
pv_uuid	string	是	本次访问的唯一标识
user_uuid	string	是	访客唯一标识（用于计算 UV，同一访客多次访问 user_uuid 相同）
model_id	string	是	被访问的模型 id
create_time	string	是	访问发生时间，已转换为北京时间字符串，格式 yyyy-MM-dd HH:mm:ss
scan_time	int	是	本次访问的浏览停留时长（秒），最大值 1800（30 分钟）
customer_uid	string	是	客户自定义的用户标识（由接入方在嵌入 VR 时通过 sid 参数传入；未传时为空字符串）

消息码 code 取值及说明:

code 值	说明
1	成功
32001	token 校验未通过
33000	参数校验失败（如 date 格式错误）
33001	缺少必要的参数（如未传 date 或 model_id）
9999	服务端异常（如统计服务暂时不可用）