创建合作关系

我的收藏

服务商尝试与商家建立合作关系。

使用限制

无

接口说明

无

基本信息

HTTP URL	https://open.douyin.com/goodlife/v1/partner/order/create/
HTTP Method	POST
申请权限	代运营合作
权限要求	•需要申请权限，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 •需要商家授权，路径：抖音来客>店铺管理>服务应用授权

请求头

参数	描述	必须
Content-Type	application/json	是
access-token	根据这个地址获取的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：整体抽佣 •2：商品单独抽佣	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 进行排查

创建合作关系在线调试

接口说明

基本信息

请求头

请求参数

Body 请求

请求示例

响应参数

响应示例

错误码

创建合作关系