版本：v2.0

创建营期团

为指定营期（period_id）创建一个团。调用方只需提供团别名（team_nick_name），团序号（页面显示的"1团""2团"）由平台按营期自动顺延；返回的 cut_id 可直接作为创建营期组接口的入参，用于在该团下继续建组。

信息

本接口只做新增：不删除/覆盖已有团、组，不调整营员团组归属，也不分配营员（营员分团在平台侧按既有流程完成）。同一营期内别名唯一即复用同一团，重复调用为幂等（返回原有 cut_id、is_create=0）。

POST/api/createTeam

核心语义

只传别名，序号自动顺延：调用方仅提供 team_nick_name；团序号取该营期已有最大团序号 +1，尚无团时为 1，不支持由调用方指定。
展示名自动生成：响应中的 team_name = 团序号 + "团"（如"1团"），仅作展示用途、无需回传。平台团组页面按"别名优先、无别名时显示展示名"规则呈现。
同营期别名唯一，幂等复用：同一 period_id 下若已有同名团，不新建、直接返回原有团 cut_id 与 is_create=0；重复调用不产生同名重复团。
营期须真实存在：period_id 对应营期不存在或已不可用时直接失败，不会创建营期团。
只做新增：不删除/覆盖已有团、组；不调整营员团组归属；不分配营员。
工具接口契约：code 恒为 0；成功时 msg 为空、data 为结果对象；失败时 msg 非空、data 为空数组。业务成功与否以 msg 判定。
并发建议：同一团别名的创建请求建议串行发起，避免并发写入产生重复团。

请求参数

名称	类型	描述	是否必填	默认值	备注
token	String	身份校验令牌	必填	-	由获取访问令牌获得
period_id	Number	营期 ID	必填	-	见获取营期日期；`period_id <= 0` 视为未传
team_nick_name	String	团别名	必填	-	如"牛剑2期"；首尾空白自动去除，去除后为空视为未传

CURL

V1

curl --location --request POST 'https://open.xinduobang.cn/api/createTeam' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'period_id=33045' \
--data-urlencode 'team_nick_name=牛剑2期'

V2（appid 为 `V2` 版本）

curl --location --request POST 'https://open.xinduobang.cn/api/createTeam' \
--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 'period_id=33045' \
--data-urlencode 'team_nick_name=牛剑2期'

信息

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

成功响应

新建成功

{
  "code": 0,
  "msg": "",
  "data": {
    "period_id": 33045,
    "cut_id": 43,
    "team_name": "1团",
    "team_nick_name": "牛剑2期",
    "is_create": 1
  }
}

幂等复用（同营期已存在同名团）

{
  "code": 0,
  "msg": "",
  "data": {
    "period_id": 33045,
    "cut_id": 43,
    "team_name": "1团",
    "team_nick_name": "牛剑2期",
    "is_create": 0
  }
}

响应字段说明

键	类型	说明
data.period_id	Number	入参营期 ID
data.cut_id	Number	团 ID，创建营期组接口的入参
data.team_name	String	团展示名（团序号 + "团"），仅展示用
data.team_nick_name	String	团别名（首尾空白已去除）
data.is_create	Number	`1`=本次新建；`0`=同营期内同名团已存在并复用

失败响应

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

{ "code": 0, "msg": "营期不存在period_id=33045", "data": [] }

错误文案	说明
`period_id不能为空`	`period_id` 缺失或非法（`<= 0`）
`team_nick_name不能为空`	`team_nick_name` 缺失或去除空白后为空串
`营期不存在period_id=x`	营期 ID 无效（不存在或已不可用），请核对营期
`创建团失败 period_id=x team_nick_name=y`	参数校验通过但创建未成功，请联系平台核查

变更记录

日期	变更
2026-10-19	首次发布：`/api/createTeam`（POST：`period_id` + `team_nick_name`），透传上游 `/Tools/createTeam`。只传团别名，团序号按营期自动顺延；同一营期内别名唯一即复用同一团（幂等，`is_create=0`）；返回 `cut_id` 供后续创建营期组接口使用

核心语义​

请求参数​

CURL​

V1​

V2（appid 为 V2 版本）​

成功响应​

新建成功​

幂等复用（同营期已存在同名团）​

响应字段说明​

失败响应​

相关接口​

变更记录​