抖音开放平台Logo
开发者文档
生活服务商家应用
“/”唤起搜索
控制台
  • 生活服务商家应用 OpenAPI SDK 总览
  • OpenAPI
  • 接入前准备
  • 通用接口
  • 订单查询
  • 团购核销
  • 三方码
  • 团购退款
  • 团购对账
  • 商品发布
  • 商品查询
  • 门店相关接口
  • 会员接入
  • 招商入驻
  • KA核销对账
  • 代运营合作
  • 创建合作关系
  • 合作列表获取
  • 合作详情查询
  • 代运营佣金
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档（不推荐）

    • 创建合作关系

    收藏
    我的收藏
    服务商尝试与商家建立合作关系。
    使用限制
    无

    接口说明

    无

    基本信息

    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 进行排查
    ​