创建合作关系
收藏
我的收藏服务商尝试与商家建立合作关系。
使用限制
无
接口说明
无
基本信息
HTTP URL | ||||
HTTP Method | POST | |||
申请权限 | 代运营合作 | |||
权限要求 |
|
请求头
参数 | 描述 | 必须 |
Content-Type | application/json | 是 |
access-token | 是 |
请求参数
Body 请求
名称 | 类型 | 是否必填 | 描述 | 示例值 |
account_id | string | 是 | 商家id(注意:并不是PoiID/门店id,请看右边截图-右上角为account_id) | 7063315566466975788 |
cooperation_content | int64 | 是 | 合作类型。 5 表示代运营,当前只有 5 | |
start_time | int64 | 是 | 合作开始时间,精确到秒,不能选择过去的时间 | 1671955800 |
end_time | int64 | 是 | 合作结束时间,精确到秒,合作时间不得小于 3 个月 | 1698221400 |
charge_type | int64 | 是 | 收费类型:
| 1 |
commission_ratio | string | 否 | 商品分佣比例,万分位("1234"表示服务商分佣比例 12.34%)。 注意:仅当整体抽佣需要传入该字段 | 1234 |
请求示例
https://open.douyin.com/goodlife/v1/partner/order/create/
{ "account_id": "7063315566466975788", "cooperation_content": 5, "start_time": 1661415000, "end_time": 1669367400, "charge_type": 2 }
响应参数
名称 | 类型 | 描述 | 示例值 |
data | struct | | |
.order_id | string | 订单id | 7135354259311118380 |
.error_code | int64 | 错误码,0为成功 | 0 |
.description | string | 错误码描述 | success |
extra | struct | | |
.error_code | int64 | 错误码,0为成功 | 0 |
.description | string | 错误码描述 | success |
.sub_error_code | int64 | 子错误码 | 0 |
.sub_description | string | 子错误码描述 | |
.logid | string | 请求id | 20220825160718010225082199060C966B |
.now | int64 | 接口响应时间,时间戳,单位秒 | 1661414840 |
响应示例
{ "data": { "order_id": "7135354259311118380", "error_code": 0, "description": "success" }, "extra": { "sub_error_code": 0, "description": "success", "error_code": 0, "logid": "20220825160718010225082199060C966B", "now": 1661414840, "sub_description": "" } }
错误码
HTTP 状态码 | 错误码 | 错误信息 | 排查建议 |
200 | 2190008 | access_token 无效 | 调用接口重新生成 access_token |
200 | 2100005 | 参数不合法 | 根据 sub_description 进行排查 |