获取营种浏览明细
根据营种 ID 和时间范围查询该营种的历史浏览记录，返回每条浏览的访问时间、浏览时长、用户信息等。
POST/api/productAccessLog
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| token | String | 身份校验令牌 | 必填 | - | 由 获取访问令牌 获得 |
| pid | Number | 营种ID | 必填 | - | 见 获取营种列表 |
| starttime | String | 查询开始时间 | 必填 | - | 如 2026-09-01 或 2026-09-01 00:00:00 |
| endtime | String | 查询结束时间 | 必填 | - | 与 starttime 间隔不得超过 30 天 |
| pageNum | Number | 页码 | 非必填 | 1 | 分页页码 |
| pageSize | Number | 每页条数 | 非必填 | 20 | 每页返回数量，最大不超过 20 |
CURL
V1
curl --location --request POST 'https://open.xinduobang.cn/api/productAccessLog' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'pid=24' \
--data-urlencode 'starttime=2026-09-01' \
--data-urlencode 'endtime=2026-09-20'
V2（appid 为 V2 版本）
curl --location --request POST 'https://open.xinduobang.cn/api/productAccessLog' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-Timestamp: 1770000000' \
--header 'X-Nonce: 3f9c1a7b2e6d4058' \
--header 'X-Signature: <computed_hmac_sha256>' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'pid=24' \
--data-urlencode 'starttime=2026-09-01' \
--data-urlencode 'endtime=2026-09-20'
成功响应
{
"code": 0,
"msg": "success",
"data": [
{
"addtime": "2026-09-18 14:32:05",
"view_time": 36,
"openid": "oABCD_xxxx",
"uid": "10086",
"phone": "13800138000",
"username": "小明"
}
],
"totalnum": 58
}
| 字段 | 类型 | 说明 |
|---|---|---|
| addtime | String | 访问时间，格式 Y-m-d H:i:s |
| view_time | Number | 浏览时长，单位：秒 |
| openid | String | 用户微信 openid |
| uid | String | 用户 uid（优先从用户表匹配，找不到再从门店用户表匹配） |
| phone | String | 用户手机号 |
| username | String | 用户微信昵称 |
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 4001 | 缺少必要参数 | 请检查 pid、starttime、endtime 是否已传 |
| 200 | 4001 | 时间间隔不得超过30天 | 请缩小查询时间范围 |
| 200 | 4001 | 时间格式不正确 | 请检查时间格式，如 2026-09-01 或 2026-09-01 00:00:00 |
备注
- 仅返回
view_time > 0的有效浏览记录 uid查找逻辑：先通过openid匹配用户表的xc_openid，若未找到再通过openid匹配门店用户表的openidusername为 base64 解码后的微信昵称
相关接口
- 获取营种列表：
获取营种列表