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

获取营期日期

根据营种 ID 查询可报名营期列表，返回营期名称、期次、period_id、起止/报名截止时间及库存、已售数量。

POST/api/periodByProduct

请求参数​

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

CURL​

curl --location --request POST 'https://open.xinduobang.cn/api/periodByProduct' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN' \
--data-urlencode 'pid=14'

成功响应​

{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "name": "2019/01/01-2019/01/10",
      "period_id": "55",
      "per_name": "第一期",
      "course_id": "8",
      "start_time": "2019-01-01",
      "end_time": "2019-01-10",
      "bend_time": "2018-12-31 23:59:59",
      "small_sum_used_stock": "12",
      "big_sum_used_stock": "3",
      "small_total_stock": "50",
      "big_total_stock": "20",
      "pid": 14
    },
    {
      "name": "2018/01/01-2018/01/10",
      "period_id": "56",
      "per_name": "",
      "course_id": "9",
      "start_time": "2018-01-01",
      "end_time": "2018-01-10",
      "bend_time": "2017-12-31 23:59:59",
      "small_sum_used_stock": "0",
      "big_sum_used_stock": "0",
      "small_total_stock": "30",
      "big_total_stock": "0",
      "pid": 15
    }
  ]
}
字段类型说明
nameString营期时间段
period_idString营期 ID
per_nameString期次名称（如有）
course_idString内部营地 ID（一般无需关注，对接请使用 pid/period_id）
start_timeString开营日期，格式 YYYY-MM-DD
end_timeString结营日期，格式 YYYY-MM-DD
bend_timeString报名截止时间，格式 YYYY-MM-DD HH:mm:ss，超过该时间不可报名
small_total_stockString儿童库存（多规格营种为该营期下各规格组合的儿童库存累加）
small_sum_used_stockString儿童已售数量（多规格营种为该营期下各规格组合的已售数量累加）
big_total_stockString成人库存（多规格营种为该营期下各规格组合的成人库存累加）
big_sum_used_stockString成人已售数量（多规格营种为该营期下各规格组合的已售数量累加）
pidNumber所属营种 ID
提示

剩余可报名数量 = 库存 - 已售数量（儿童、成人分别计算）。

失败响应​

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

相关接口​