抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 代运营
  • 创建合作关系
  • 合作列表获取
  • 合作详情查询
  • 商服关系状态回调
  • 创建/修改佣金
  • 佣金变更记录列表
  • 佣金变更记录详情
  • 商品佣金详情
  • 佣金状态变更回调
  • 团购退款
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 创建合作关系

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

    接口说明

    无​

    基本信息

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