发布/修改短视频定向佣金计划
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/match/v2/poi/save_video_oriented_plan/
使用限制
接口说明
权限要求
错误码
| HTTP 状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 28001007 | 商品不存在 | 请检查商品 ID 是否是上传商品时返回的抖音内部商品 ID 使用多门店SPU同步接口(/poi/v2/spu/sync/)的对应返回数据中的spu_id字段 使用新商品库接口(/life/goods/product/save/)的对应返回数据中的product_id字段 抖音来客商品获取商品ID路径：抖音来客 -> 商品管理 使用创建/发布团购活动接口(/goodlife/v1/goods/product/save/)对应返回的数据中的product_id字段 |
| 达人抖音 ID 不存在，请检查后重试 | |||
| 佣金计划不存在 | |||
| plan_name 不能为空 | |||
| douyin_id_list 不可为空 | |||
| merchant_phone 不能为空 | |||
| product_list 不能为空 | |||
| 抽佣比例不符合要求，需在 0% - 29% 以 内 | |||
| 只可添加商品、达人，延长视频发布时间或更新商品佣金及商家手机号 | 修改计划时，仅可仅可添加商品、修改商品佣金、添加达人、修改商家联系人、延长视频发布时间。 | ||
| 达人未入驻，请达人前往抖音 App 搜索“团购达人”并完成入驻 | 传入的抖音号必须已经入驻成为本地团购达人 | ||
| 不满足商品底线 | |||
| 商品关联的计划超出限制，一个商品最多只能关联 20 个进行中的定向计划 | 一个商品最多只能关联 20 个进行中的计划 | ||
| 抽佣比例不符合要求，需在 0% - 80% 以内 | 开环代运营商品的抽佣比例不符合要求，需在 0% - 80% 以内 | ||
| 200 | 28001033 | 访问接口QPS超过限制 | 接口限制 100QPS，请控制好请求速率 |
| 200 | 28013022 | 达人设置异常触发封禁，请明日再试 | 出于安全考虑，请求参数中含有“非团购带货达人的抖音号ID”会被视为异常，异常请求当天超过 50 次，则禁止应用当日再调用本接口 |
| 200 | 28013018 | 无权操作该商品，只有商品的创建者或所属的小程序有权限，请检查 access_token 及对应的 client_key 是否满足条件 | 仅当调用接口的应用与计划关联的商品存在以下关系时允许调用本接口 应用是商品的创建者 应用是商品所属的小程序 请检查 access_token 及对应的 client_key 是否满足条件 |
| 200 | 28013012 | 未签署《撮合平台用户服务协议》，请在开发者平台的站内信中完成签署后重试（站内信标题为“撮合协议签署”），如已 签署仍持续报错可联系平台技术 oncall | |
| 200 | 28013020 | 暂无操作该商品的权限 | 检查行业身份“生活服务代运营服务商”是否点亮成功 |
| 200 | 28001005 | 系统内部错误，请重试 | |
| 当前计划状态错误，请检查计划状态是否处于“进行中”，其他状态不支持修改 | 检查计划状态是否处于“进行中” | ||
| 商品 XXX 为低质商品，不支持计划带货 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/match/v2/poi/save_video_oriented_plan/' \
--header 'access-token: clt.e1db986079eb5179710c6f879950f15fCNWVVP3OUelc8JwbYwpVoAgW5f9v' \
--header 'Content-Type: application/json' \
--data-raw '{
"plan_id": 7130156490383444012,
"plan_name": "XX商品定向佣金计划名称",
"start_time": 1660285218,
"end_time": 1660285220,
"commission_duration": 86400,
"merchant_phone": "13512345678",
"douyin_id_list": [
"38377163415"
],
"product_list": [
{
"product_id": 7088277603718563884,
"commission_rate": 1666
}
]
}'响应示例响应示例
200 - 成功示例
{
"data": {
"plan_id": 7132649893285333000
},
"err_no": 0,
"err_msg": "",
"log_id": "20220426184533010225145152084C7731"
}请求参数
Header 参数
access-token
string
必需
示例值:
clt.e1db986079eb5179710c6f879950f15fCNWVVP3OUelc8JwbYwpVoAgW5f9v
Content-Type
string
必需
示例值:
application/json
Body 参数application/json