修改定向佣金计划状态
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/match/v2/poi/update_oriented_plan_status/
使用限制
接口说明
| 进行中(1) | 短视频定向计划： 该计划发布成功，未到视频发布deedline时间，有待履约的指定达人 该计划发布成功，已过视频发布deedline时间，有已发布视频的指定达人，且分佣时间未结束 直播间定向计划： 该计划发布成功，有待履约的指定达人（没有取消全部达人），且未被关停 该计划发布成功，有已发布直播的指定达人，且未被关停 |
|---|---|
| 已完成(2) | 短视频定向计划： 该计划发布成功，已过视频发布deedline时间，有已发布视频的指定达人，且全部达人分佣时间已结束 直播间定向计划： 该计划发布成功，有已发布直播的指定达人，且商家关停了该计划 |
| 已取消(3) | 短视频定向计划： 商家手动操作取消指定达人合作 已过视频发布时间，计划所有达人均未发布视频 直播间定向计划： 商家手动操作取消指定达人合作 商家关停了该计划，计划所有达人均未发布直播 |
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001007 | 佣金计划不存在，请检查计划ID是否正确 | 检查计划ID是否正确 |
| 短视频计划状态不支持修改 | 仅支持取消直播间场景 下的定向佣金计划 | ||
| 参数错误 | 检查 status 是否为3 | ||
| 200 | 28013018 | 无权操作该商品，只有商品的创建者或所属的小程序有权限，请检查access-token及对应的client_key是否满足条件 | 仅当调用接口的应用与计划关联的商品存在以下关系时允许调用本接口 应用是商品的创建者 应用是商品所属的小程序 请检查access-token及对应的client_key是否满足条件 |
| 200 | 28013020 | 暂无操作该商品的权限 | 检查行业身份“生活服务代运营服务商”是否点亮成功 |
| 200 | 28001005 | 系统内部错误，请重试 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/match/v2/poi/update_oriented_plan_status/' \
--header 'access-token: clt.6f3d96edd825ef65463706f18ac9ddcdFZfKNWDaRcErCdWxbSkoOJZ7O1Ph' \
--header 'Content-Type: application/json' \
--data-raw '{
"plan_update_list": [
{
"plan_id": 7130537699240986668,
"status": 3
}
]
}'响应示例响应示例
200 - 成功示例
{
"data": {
"fail_plan_id_list": [
1
]
},
"err_no": 0,
"err_msg": "",
"log_id": "20220426184533010225145152084C7731"
}请求参数
Header 参数
access-token
string
必需
示例值:
clt.6f3d96edd825ef65463706f18ac9ddcdFZfKNWDaRcErCdWxbSkoOJZ7O1Ph
Content-Type
string
必需
示例值:
application/json
Body 参数application/json