跳到主要内容
版本：v2.0

用户行为轨迹

基于会员 UID 查询该用户的行为轨迹（浏览、进入小程序、提交/支付/取消订单、分享、核销等），与后台「会员详情-行为轨迹」页同源。每条记录返回行为时间、行为描述文本、停留时长及关联对象，支持时间起点过滤、分页。

GET/api/getUserTrace

核心语义​

  1. 按会员维度查询：以 uid（会员 UID）为主键返回该用户的全部行为记录，按行为时间倒序（最新在前）。
  2. 行为描述开箱即用：content 为纯文本（无 HTML 标签），已包含营种名称、订单号、所属员工、邀请人、场景值等注记，可直接展示或入库。
  3. 停留时长过滤：max_time 传入且大于 0 时，过滤掉停留时长不足指定秒数的浏览类记录（与后台页面「仅显示停留时间大于 1 分钟」一致，通常传 60）。
  4. 不返回总条数：本接口 data 中没有 total 字段——行为日志有效记录数不定，请循环翻页直至 list 为空或条数不足 pageSize 即视为结束。
  5. 展示口径与后台一致：部分内部埋点类、消息类行为日志不在返回范围内，因此相邻两条记录时间可能不连续。
  6. 契约：code 恒为 0；成功时 msg 为空；失败时 msg 非空、data 为空数组。业务成功与否以 msg 判定。

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
uidNumber会员 UID必填-见 获取会员列表
start_timeString行为时间起点选填不限只返回该时间之后的行为记录；日期字符串（如 2026-05-01）或时间戳
max_timeNumber停留时长过滤阈值（秒）选填不筛选传入且大于 0 时，过滤掉停留时长不足该秒数的浏览类记录（通常传 60）
pageNumNumber页码选填1从 1 开始
pageSizeNumber每页条数选填10最大 20（超出按 20 返回）

CURL​

V1（GET）​

curl --location --request GET 'https://open.xinduobang.cn/api/getUserTrace?token=YOUR_TOKEN&uid=8034&pageSize=2'

V1（POST）​

curl --location --request POST 'https://open.xinduobang.cn/api/getUserTrace' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'uid=8034' \
--data-urlencode 'start_time=2026-05-01' \
--data-urlencode 'max_time=60' \
--data-urlencode 'pageNum=1' \
--data-urlencode 'pageSize=20'

V2（appid 为 V2 版本）​

curl --location --request POST 'https://open.xinduobang.cn/api/getUserTrace' \
--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 'uid=8034' \
--data-urlencode 'pageSize=20'
信息

V2 签名算法及 X-Signature 计算方式见 V2 接入示例。

成功响应​

{
  "code": 0,
  "msg": "",
  "data": {
    "pageNum": 1,
    "pageSize": 2,
    "list": [
      {
        "action_time": "2026-10-30 18:15:15",
        "type": 55,
        "content": "支付营种：示例营种A，订单号：NO20261030181512364910",
        "stay_seconds": 0,
        "access_id": 142611
      },
      {
        "action_time": "2026-10-30 18:15:12",
        "type": 57,
        "content": "提交营种订单：示例营种A，订单号：NO20261030181512364910【订单所属员工：王*磊】",
        "stay_seconds": 0,
        "access_id": 142611
      }
    ]
  }
}

data 字段说明​

字段类型说明
pageNumNumber当前页码
pageSizeNumber每页条数
listArray行为记录列表，按时间倒序（最新在前）；无 total 字段，翻页直至 list 为空或不足 pageSize 即结束

list[] 字段说明​

字段类型说明
action_timeString行为发生时间，格式 YYYY-MM-DD HH:mm:ss
typeNumber行为类型编码（见下方对照表），如 2=浏览营种详情、55=支付营种订单、57=提交营种订单、58=取消营种订单等
contentString行为描述纯文本，已包含营种名称、订单号、所属员工、邀请人、场景值等注记，如 支付营种：xxx营种，订单号：NO2026…
stay_secondsNumber该次行为停留时长（秒）；订单、分享等非浏览类行为为 0
access_idNumber关联对象 ID，含义随 type 变化：浏览类为营种 ID，订单类为订单 ID；无关联对象时为 0

注意事项​

  • 本接口不返回总条数 total：请循环翻页直至 list 为空或条数不足 pageSize 即视为结束。
  • 部分内部埋点类、消息类行为日志不在展示范围内（与后台页面展示口径一致），因此相邻两条记录时间可能不连续。
  • content 为纯文本（无 HTML 标签），可直接展示或入库。

失败响应​

契约下 code 恒为 0，失败通过非空 msg 与空 data 标识。

{ "code": 0, "msg": "uid不能为空", "data": [] }
{ "code": 0, "msg": "会员不存在", "data": [] }
{ "code": 0, "msg": "start_time格式错误", "data": [] }
错误文案说明
uid不能为空uid 缺失
会员不存在uid 对应的会员不存在
start_time格式错误start_time 无法解析为日期字符串或时间戳

附录：行为类型编码（type）对照表​

以下为本接口实际可能返回的全量类型（部分内部埋点类型已被平台展示口径过滤，不会下发）。content 为行为描述模板，{xxx} 表示动态内容（营种/商品/文章名称、订单号等）。

访问与浏览​

type含义content 模板
1访问首页访问：首页
2浏览营种详情访问：{营种名称}
3访问营种列表访问：营种列表
4访问商城列表访问：商城列表
5浏览商城商品详情访问：{商品名称}
7查看营种往期回顾在营种 {营种名称} 详情页-查看往期回顾
8访问自定义装修页访问自定义装修页：{页面名称}

分享​

type含义content 模板
50分享首页分享：首页
51分享拼团分享：拼团
52分享商城商品分享：{商品名称}
53分享营种分享：{营种名称}
54分享营种列表分享：营种列表
67分享商城列表分享：商城列表
69分享砍价分享：砍价

订单与交易​

type含义content 模板
55支付营种订单支付营种：{营种名称}，订单号：{订单号}
56实名认证认证
57提交营种订单提交营种订单：{营种名称}，订单号：{订单号}【订单所属员工：{姓名}】
58取消营种订单取消营种订单：{营种名称}，订单号：{订单号}
59商城下单商城下单：{商品名称}
60取消商城订单取消商城订单：{商品名称}
61支付商城订单支付商城订单：{商品名称}
62购买年卡购买年卡：{年卡名称}
63支付差价支付差价
64购买 VIP购买vip
65领取临时订单领取临时订单
66确认临时订单确认临时订单：订单号：{订单号}
183提交满营排队报名提交满营排队报名：{营种名称}
184提交满营排队报名（生成订单）提交满营排队报名：{营种名称}，订单号：{订单号}
185抖音订单退款抖音退款：{营种名称}，订单号：{订单号}
186抖音下单抖音下单：{营种名称}，订单号：{订单号}
187绑定抖音订单绑定抖音订单：{订单信息}
206绑定会员绑定会员：会员编号.{UID}【{姓名}-{手机号}】绑定

页面行为与互动埋点​

type含义content 模板
68初次进入系统初次进入系统
70阅读文章阅读文章：{文章标题}
71确认隐私协议确认隐私
72分享报名表分享报名表：订单号：{订单号}
73点击分享报名表点击分享报名表：订单号：{订单号}
74保存分享报名表数据保存分享报名表数据：订单号：{订单号}
80浏览营种评价浏览营种评价，营种名称：{营种名称}
83营种详情页拉到页底营种名称：{营种名称} ,拉到了页面底部
84文章阅读进度仅在有有效埋点数据时返回
85详情页点击去往个人中心营种名称：{营种名称} ,由详情页点击去往个人中心
86点击查看已报名人数营种名称：{营种名称} ,由详情页点击查看已经报名人数,现有报名人数 {N}
87详情页点击选择营期营种名称：{营种名称} ,由详情页点击选择营期
88详情页点击回到首页营种名称：{营种名称} ,由详情页点击回到首页
89详情页点击咨询按钮营种名称：{营种名称} ,由详情页点击咨询按钮
90详情页点击查看全部评价营种名称：{营种名称} ,由详情页点击查看全部评价
91营种列表搜索仅在有有效埋点数据时返回
92年卡详情页点击预约营种在年卡 {年卡名称} 的详情页，点击去预约的营种为：{营种名称}
93详情页点击年卡优惠项营种名称：{营种名称},由详情页点击年卡优惠项{规格信息}
94下单页点击查看订单明细营种名称：{营种名称},营种下单页点击查看订单明细
95营种下单页行为仅在有有效埋点数据时返回
96详情页邀请好友参团营种名称：{营种名称}, 详情页邀请好友一起参团
97个人中心查看储值卡用户个人中心：点击查看储值卡列表， 当前用户的储值卡张数{N}
98订单详情页查看协议在营种订单{订单号}的详情页， 当前用户查看了订单协议
99订单详情页查看缴费证明在营种订单 {订单号} 的详情页， 当前用户点击查看缴费证明
100个人中心查看年卡用户个人中心：点击查看年卡， 当前用户的年卡张数 {N}
101个人中心查看 VIP用户个人中心：点击查看VIP， 当前用户{VIP信息}
102个人中心查看全部订单用户个人中心：点击查看全部订单
103查看年卡详情页在用户个人中心，查看了年卡 {年卡名称} 的详情页
备注
  • 行为描述末尾可能追加 【场景值：xxx】、【邀请会员：xxx】、【销售链接：xxx】 等注记；
  • 未列入本表的行为类型编码均不会经由本接口下发；平台后续新增行为类型时，以接口实际返回为准。

相关接口​

变更记录​

日期变更
2026-11-03首次发布：/api/getUserTrace（GET/POST：uid 必填，start_time/max_time/分页选填），透传上游 /Tools/getUserTrace。按会员 UID 查询行为轨迹（与后台「会员详情-行为轨迹」同源）：浏览/下单/支付/取消/分享/核销等，时间倒序；content 为含注记的纯文本；不返回 total，翻页至空即结束；附录含行为类型编码全量对照表