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

获取营期分团分组详情

按营期 ID 查询分团、分组结构（团名、组名及昵称），可用于核对团组配置或对接团组变更回调。

POST/api/getPeriodGroup

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
period_idString营期 ID必填-多个用英文逗号分隔，如 39,46；见 获取营种营期

CURL​

curl --location --request POST 'https://open.xinduobang.cn/api/getPeriodGroup' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "YOUR_TOKEN",
    "period_id": "39,46"
}'

成功响应​

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "period_id": "39",
      "data": [
        {
          "cut_id": "43",
          "team_name": "1团",
          "team_nick_name": "牛剑2期",
          "group_list": [
            {
              "group_id": "120",
              "group_name": "1组",
              "group_nick_name": "心理"
            },
            {
              "group_id": "518",
              "group_name": "2组",
              "group_nick_name": "物理1营"
            }
          ]
        }
      ]
    }
  ]
}

data[] — 按营期​

字段类型说明
period_idString营期 ID
dataArray该营期下的分团列表

data[].data[] — 分团​

字段类型说明
cut_idString分团 ID
team_nameString团名称，如 1团
team_nick_nameString团昵称
group_listArray分组列表

group_list[] — 分组​

字段类型说明
group_idString分组 ID
group_nameString组名称，如 1组
group_nick_nameString组昵称

失败响应​

HTTP状态码错误码描述排查建议
200非 0业务错误确认 period_id 与 token 是否有效

相关接口​