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

查询营员信息

按订单号或营期查询营员报名字段。ordernum 与 period_id 至少传一个。返回的表头 student_title 与数据行字段随营期自定义表单变化。

POST/api/getStudentInfo

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
ordernumString订单号条件必填-与 period_id 至少填一个
period_idNumber营期 ID条件必填-与 ordernum 至少填一个
openidString会员 openid非必填-按会员过滤
pageNumNumber分页页码非必填1-
pageSizeNumber每页条数非必填100最大 200

CURL​

curl --location --request POST 'https://open.xinduobang.cn/api/getStudentInfo' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "YOUR_TOKEN",
    "period_id": 5300,
    "pageNum": 1,
    "pageSize": 10
}'

成功响应​

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "student_title": {
      "name": "学校及班级全称",
      "beizhu": "拍摄日期",
      "pichead": "营员头像",
      "user_name": "营员姓名",
      "user_phone": "营员手机",
      "goods_name": "营种",
      "pername": "营期名称",
      "ordernum": "订单号",
      "team_name": "团队名称",
      "group_name": "小组名称",
      "order_remarks": "订单备注",
      "join_count": "参营次数"
    },
    "student_list": [
      {
        "name": "杭州娃哈哈双语学校2025届2班",
        "beizhu": "2月11日",
        "pichead": "https://file3.xdbcdn.cn/imagevideo/1739975990893/temp/2686.jpg",
        "user_name": "--",
        "user_phone": "18520339063",
        "goods_name": "示例营种",
        "pername": "",
        "ordernum": "NO20250220155014679153",
        "team_name": "1团",
        "group_name": "1组",
        "order_remarks": "",
        "period": "2025/04/01-2025/04/02",
        "join_count": 1,
        "status_str": "已支付"
      }
    ]
  }
}
字段类型说明
student_titleObject表头：键为字段名，值为中文列名（随营期表单变化）
student_listArray营员数据行；除自定义表单字段外，常见还有 ordernum、team_name、group_name、period、status_str、join_count 等
status_strString订单状态文案，如已支付、已结营、已退款、待支付尾款、换营中、退款中等

失败响应​

HTTP状态码错误码描述排查建议
200非 0业务错误ordernum 与 period_id 至少传一个；pageSize 不超过 200

相关接口​