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

获取营员信息

按订单号、营期或会员 openid 查询营员报名字段。ordernum、period_id、openid 至少传一个。返回的表头 student_title 与数据行字段随营期自定义表单变化。当传入 openid 且 select_type=all 时，将查询该会员所有关联营员的数据。

POST/api/getStudentInfo

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
ordernumString订单号条件必填-与 period_id、openid 至少填一个
period_idNumber营期 ID条件必填-与 ordernum、openid 至少填一个
openidString会员 openid条件必填-与 ordernum、period_id 至少填一个
select_typeString查询类型非必填-传 all 时查询该 openid 对应会员所有关联营员；需与 openid 配合使用
pageNumNumber分页页码非必填1-
pageSizeNumber每页条数非必填100最大 200

CURL​

curl --location --request POST 'https://open.xinduobang.cn/api/getStudentInfo' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'period_id=5300' \
--data-urlencode 'pageNum=1' \
--data-urlencode 'pageSize=10'

查询会员所有关联营员​

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

成功响应​

{
  "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": [
      {
        "sid": 16516,
        "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营员数据行；除自定义表单字段外，常见还有 sid、ordernum、team_name、group_name、period、status_str、join_count 等
sidNumber营员 ID
status_strString订单状态文案，如已支付、已结营、已退款、待支付尾款、换营中、退款中等

失败响应​

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

相关接口​