佣金计划创建与修改
收藏
我的收藏接口说明
- 创建/更新佣金计划,创建计划使用维度id,更新计划使用计划id。
- 定向计划以及商品维度通用计划创建时同步返回结果,门店维度通用计划异步返回结果,接入方需要开放平台webhook事件监听获取创建结果;更新同步返回结果。
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/goodlife/v1/trip/hotel/commission_rate/save/ |
HTTP Method | POST |
Scope | life.capacity.hotel_commission_rate_save |
权限要求 | 酒店行业日历房解决方案-创建及修改佣金计划 |
请求参数
请求头
access-token必填String
示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
content-type必填String
固定值"application/json"
Body展开全部子属性
account_id必填String
商户id
plan_detailStruct
佣金计划详情
展开子属性
请求示例
curl --location --request POST 'https:// open.douyin.com/goodlife/v1/trip/hotel/commission_rate/save/' \ --header 'content-type: application/json' \ --header 'access-token: 0801121846735352506a356a6' \ --data '{"account_id":"aijt5RuX07","plan_detail":{"start_time":2337690422945230203,"end_time":2381946204237854631,"product_ids":["HVycaBn35j"],"plan_ids":["0a1lGnMicu"],"dimension_ids":["iEqkpvOYxm"],"commission_rate":4559336192950456872,"plan_name":"PMUtp13nxw","talent_ids":["mW9069M08c"],"dimension_type":1,"plan_contact_phone":"L6zoeqhDhI","scene_type":1,"plan_type":1,"commission_duration":3837513187823081054},"base":{"addr":"3AyVsN5SPv","client":"04k8zUanOU","traffic_env":{"open":false,"env":"Wy1gDaixrX"},"extra":{"aiwP0oPmQQ":"lwYzTiCDT5"},"log_i_d":"4Yov1fxMSl","caller":"C8NcYjH9sY"}}'
响应参数
Body展开全部子属性
dataList
返回数据内容
展开子属性
extraStruct
额外信息
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": [ { "id": "QEMlSkiPIY", "plan_id": "0EssVjkF3v", "code": 311855294364808960, "message": "eGqkTXdbzw", "failed_talent_ids": [ "SBpWREpUmD" ] } ], "extra": { "error_code": 0, "description": "", "sub_error_code": 0, "sub_description": "", "logid": "20241205014526AE66F03F4366C77764AE", "now": 1733334326 }, "base_resp": { "extra": { "5LZfoFYx9w": "nJi0hDf7RW" }, "status_message": "kutf01Y5z3", "status_code": 4595779870500949500 } }
切换单列布局
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 2100001 | 未知错误 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100004 | 系统繁忙,此时请开发者稍候再试 | 重试接口,重试3次仍报错联系抖音生活服务技术支持 |
200 | 2100005 | 参数不合法 | 更换参数 |
200 | 2190002 | access_token无效 | 调用接口重新生成access_token |
200 | 2190004 | 应用未获得该能力, 请去https://open.douyin.com/申请 | 应用申请接口权限 |
200 | 2190008 | access_token过期,请刷新或重新授权 | 规范token刷新机制,检查是否有测试环境在同步刷新token |
200 | 2119001 | 参数不合法 | 更换参数 |
200 | 2119002 | 系统繁忙,请稍候再试 | 重试 |
200 | 2119003 | 请求太过频繁,请稍后再试 | 重试 |
200 | 2119005 | 应用未获商家授权 | 联系合作商家在商家后台发起授权,并在服务商后台同意授权 |
200 | 3000001 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 4000001 | 根据实际业务错误返回 | 补充参数 |
200 | 4000002 | 根据实际业务错误返回 | 对照接口文档规范参数并重试 |
200 | 5000001 | 根据实际业务错误返回 | 联系抖音处理 |
200 | 5000001 | 服务器打瞌睡了,请稍后再试。 | |
200 | 3000001 | 以实际错误信息为准 |
点击纠错