获取营期照片

按营期分页查询照片列表，可按营员、上传时间、标签筛选。

POST/api/getStudentPicList

请求参数

名称	类型	描述	是否必填	默认值	备注
token	String	身份校验令牌	必填	-	由 获取访问令牌 获得
period_id	Number	营期 ID	必填	-	-
sid	Number	营员编号	非必填	-	-
idcard	String	营员证件号	非必填	-	-
studentname	String	营员姓名	非必填	-	-
starttime	String	上传开始日期	非必填	-	格式 Y-m-d
endtime	String	上传结束日期	非必填	-	格式 Y-m-d
tag_id	String	照片标签 ID	非必填	-	见 获取照片标签
pageNum	Number	分页页码	非必填	1	-
pageSize	Number	每页条数	非必填	10	-

CURL

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

成功响应

{
  "code": 0,
  "msg": "操作成功",
  "totalnum": "2",
  "data": [
    {
      "id": "8361",
      "file": "https://album.xdbcdn.cn/hd2/xdbysh/1635/min/1768562164245_296175.png",
      "addtime": "2025-10-08",
      "width": "4051",
      "height": "3034",
      "tag": [
        {
          "tag_id": 1,
          "tag_name": "标签1"
        }
      ],
      "student_list": [
        {
          "sid": 99732,
          "name": "王洋阳"
        },
        {
          "sid": 53371,
          "name": "陈俊宇"
        }
      ]
    },
    {
      "id": "8358",
      "file": "https://album.xdbcdn.cn/hd2/xdbysh/1635/min/1768562163348_230411.jpg",
      "addtime": "2025-10-08"
    }
  ]
}

字段	类型	说明
totalnum	String	照片总数
id	String	照片 ID
file	String	图片 URL
addtime	String	上传日期
width / height	String	宽高（如有）
tag	Array	标签列表（tag_id / tag_name）
student_list	Array	关联营员（sid / name）

失败响应

HTTP状态码	错误码	描述	排查建议
200	非 0	业务错误	请检查 period_id 与 token

相关接口

• 获取照片标签：获取照片标签