获取营期任务状态

查询营期交付流程整体状态，以及设计师/剪辑师各进度节点是否点亮（color_block）。支持批量查询；若任务尚未创建，接口会自动初始化。适用于已开通相关场景的对接；未使用该场景时可忽略。

手动覆盖某节点点亮状态请使用 更新交付进度节点。

POST/api/getPeriodTaskDetail

请求参数

名称	类型	描述	是否必填	默认值	备注
token	String	身份校验令牌	必填	-	由 获取访问令牌 获得
period_id	String	营期 ID	必填	-	多个用英文逗号分隔，如 9,11

CURL

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

成功响应

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "status_str": "拍摄中",
    "status": "1",
    "color_block": [
      {
        "is_light": 0,
        "date": "",
        "item_id": 1
      },
      {
        "is_light": 0,
        "date": "",
        "item_id": 2
      },
      {
        "is_light": 0,
        "date": "",
        "item_id": 3
      },
      {
        "is_light": 0,
        "date": "",
        "item_id": 4
      },
      {
        "is_light": 0,
        "date": "",
        "item_id": 5
      }
    ]
  },
  "all_data": [
    {
      "period_id": "9",
      "data": {
        "status_str": "拍摄中",
        "status": "1",
        "color_block": [
          {
            "is_light": 0,
            "date": "",
            "item_id": 1
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 2
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 3
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 4
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 5
          }
        ]
      }
    },
    {
      "period_id": "11",
      "data": {
        "status_str": "拍摄中",
        "status": "1",
        "color_block": [
          {
            "is_light": 0,
            "date": "",
            "item_id": 1
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 2
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 3
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 4
          },
          {
            "is_light": 0,
            "date": "",
            "item_id": 5
          }
        ]
      }
    }
  ]
}

字段	类型	说明
data	Object	单个营期状态；传多个 period_id 时为最后一个营期的数据
all_data	Array	各营期状态列表，每项含 period_id 与 data
status	String	状态码：1 拍摄中，2 后期中，3 交付中，4 印刷中，5 已完成
status_str	String	状态文案；交付中可能附带 (照片交付) 或 (视频交付)
color_block	Array	交付进度节点（共 5 步：设计师 1–3，剪辑师 4–5）
color_block[].is_light	Number	0 未点亮，1 已点亮；若调用过覆盖接口，以最新覆盖为准
color_block[].date	String	点亮日期，格式 m-d；未点亮为空字符串
color_block[].item_id	Number	节点 ID（1–5），见 更新交付进度节点

失败响应

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

相关接口

• 更新交付进度节点：更新交付进度节点