通过商品 ID 查询定向佣金计划
开发环境
http://dev-cn.your-api-server.com
开发环境
http://dev-cn.your-api-server.com
POST
/api/match/v2/poi/oriented_plan_list/
使用限制
接口说明
| 状态 | 说明 |
|---|---|
| 进行中(1) | 短视频定向计划： 该计划发布成功，未到视频发布deedline时间，有待履约的指定达人 该计划发布成功，已过视频发布deedline时间，有已发布视频的指定达人，且分佣时间未结束 直播间定向计划： 该计划发布成功，有待履约的指定达人（没有取消全部达人），且未被关停 该计划发布成功，有已发布直播的指定达人，且未被关停 |
| 已完成(2) | 短视频定向计划： 该计划发布成功，已过视频发布deedline时间，有已发布视频的指定达人，且全部达人分佣时间已结束 直播间定向计划： 该计划发布成功，有已发布直播的指定达人，且商家关停了该计划 |
| 已取消(3) | 短视频定向计划： 商家手动操作取消指定达人合作 已过视频发布时间，计划所有达人均未发布视频 直播间定向计划： 商家手动操作取消指定达人合作 商家关停了该计划，计划所有达人均未发布直播 |
错误码
| 错误码 | 错误信息 | 错误排查建议 |
|---|---|---|
| 28001005 | 系统内部错误，请重试 | 发起抖音开放平台Oncall工单，务必提供如下信息 开发者所请求的Http路径、请求体信息 Http响应体信息中返回的log_id字段 |
| 未查询到记录 | 自检商品或计划绑定的商品与小程序对应的生活服务代运营服务商是否已建立商服合作关系 | |
| 28001007 | 参数不合法 | 自检请求参数是否符合接口文档的要求 |
| 28013011 | 暂无调用佣金计划相关接口的权限 | 自检小程序服务商的”生活服务代运营服务商“的行业身份是否认证成功 |
| 28013020 | 暂无操作该商品的权限 | 自检商品或计划绑定的商品与小程序对应的生活服务代运营服务商是否已建立商服合作关系 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://dev-cn.your-api-server.com/api/match/v2/poi/oriented_plan_list/' \
--header 'access-token: clt.6f3d96edd825ef65463706f18***********************' \
--header 'Content-Type: application/json' \
--data-raw '{
"spu_id_list": [
7088277603718563884
]
}'响应示例响应示例
200 - 成功示例
{
"data":
{
"data":
[
{
"plan_name": "哈哈哈",
"product_list":
[
{
"product_id": 7088277603718563884,
"commission_rate": 2666
}
],
"status": 3,
"talent_status_map":
{
"38377163415": 3
},
"commission_duration": 1000,
"create_time": "2022-08-15",
"plan_id": 7132086024917764140,
"start_time": 1661135340,
"update_time": "2022-08-15",
"content_type": 1,
"douyin_id_list":
[
"38377163415"
],
"end_time": 1661937164,
"create_time_unix": 1696949518,
"update_time_unix": 1696949518
},
{
"start_time": 0,
"status": 3,
"talent_status_map":
{
"67426157743": 3,
"38377163415": 3
},
"commission_duration": 1,
"content_type": 2,
"douyin_id_list":
[
"38377163415",
"67426157743"
],
"plan_id": 7130537699240658988,
"plan_name": "哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈",
"product_list":
[
{
"product_id": 7088277603718563884,
"commission_rate": 2666
}
],
"update_time": "2022-08-11",
"create_time": "2022-08-11",
"create_time_unix": 1696949518,
"update_time_unix": 1696949518,
"end_time": 0
}
],
"page_count": 1,
"total_count": 57,
},
"err_msg": "",
"err_no": 0,
"log_id": "20230712165544FF934AF2108A6BDA927F"
}
请求参数
Header 参数
access-token
string
必需
示例值:
clt.6f3d96edd825ef65463706f18***********************
Content-Type
string
必需
示例值:
application/json
Body 参数application/json