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

更新交付进度节点

手动覆盖某营期交付流程进度条上某一步的点亮/置灰状态。适用于已开通摄影交付进度场景的对接；未使用该场景时可忽略。

系统会按设计师/剪辑师任务自动计算进度；本接口写入覆盖记录后，再查 获取营期任务状态 时以最新一次覆盖为准。

信息

进度共 5 步（item_id = 1–5）：前 3 步为设计师，后 2 步为剪辑师。

POST/api/updatePeriodLight

请求参数​

名称类型描述是否必填默认值备注
tokenString身份校验令牌必填-由 获取访问令牌 获得
period_idNumber营期 ID必填--
item_idNumber进度节点 ID必填-见下表；也可从任务状态接口的 color_block[].item_id 取得
is_lightNumber是否点亮必填-1 点亮（视为该节点已完成），0 置灰（取消点亮）

item_id 含义​

item_id角色节点
1设计师开始
2设计师定稿
3设计师完成
4剪辑师开始
5剪辑师完成

CURL​

curl --location --request POST 'https://open.xinduobang.cn/api/updatePeriodLight' \
--header 'Content-Type: application/json' \
--data-raw '{
    "token": "YOUR_TOKEN",
    "period_id": 5300,
    "item_id": 2,
    "is_light": 1
}'

成功响应​

{
  "code": 0,
  "msg": "操作成功"
}

失败响应​

HTTP状态码错误码描述排查建议
200非 0业务错误请检查 period_id、item_id（1–5）与 token

相关接口​