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

    收藏
    我的收藏
    根据订单 ID 查询合作详情,仅支持开环订单​

    使用限制

    无​

    接口说明

    无​

    基本信息

    HTTP URL
    HTTP Method
    GET
    申请权限
    代运营合作
    权限要求
      需要申请权限 ,路径:抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 ​
      需要商家授权,路径:抖音来客>店铺管理>服务应用授权​

    请求头

    参数
    描述
    必须
    Content-Type
    application/json
    access-token
    根据这个地址获取的token​

    请求参数

    Body 请求

    名称​
    类型​
    描述​
    必需​
    示例值​
    备注​
    order_id​
    string​
    订单id​
    是​
    7134973323200432172​
    without_product_items​
    bool​
    是否不获取商品佣金​
    否​
    true \ false​
    建议不传,或者传 false。本接口最多返回200个商品佣金。请使用「商品佣金详情接口」获取商品佣金列表。​

    请求示例

    https://open.douyin.com/goodlife/v1/partner/order/get/?order_id=7134973323200432172

    响应参数

    名称​
    类型​
    是否必填​
    描述​
    示例值​
    extra​
    否​
    .error_code​
    i32​
    是​
    错误码​
    0​
    .description​
    string​
    是​
    错误码描述​
    success​
    .sub_error_code​
    i32​
    是​
    子错误码​
    0​
    .sub_description​
    string​
    是​
    子错误码描述​
    .logid​
    string​
    是​
    标识请求的唯一id​
    202008121419360101980821035705926A​
    .now​
    i64​
    是​
    毫秒级时间戳​
    1597213176393​
    data​
    struct​
    否​
    .status​
    i32​
    是​
    订单状态​
    102=待商户确认​
    201=服务完成(服务中,当前时间到达服务结束时间,变成服务完成)​
    301=等待服务(商家确认后,但当前时间没有到达预期服务开始时间,则状态停留在301)​
    302=服务中(商家确认后,当前时间到达服务开始时间,变成服务中)​
    401=服务取消(注意:当前时间到达服务开始时间之后,如果商家还没接单,则会自动取消)
    .id​
    string​
    是​
    订单号​
    7140183682702346284​
    .account_id​
    string​
    是​
    商户id​
    7062632006445713452​
    .start_time​
    i64​
    是​
    合作开始时间,秒级时间戳​
    1662537542​
    .end_time​
    i64​
    是​
    合作结束时间,秒级时间戳​
    .create_time​
    i64​
    是​
    下单时间,秒级时间戳​
    1670399942​
    .merchant_name​
    string​
    是​
    商户名​
    城乡世纪广场​
    .product_name​
    string​
    否​
    服务名称​
    代运营(开环)​
    .charge_type​
    i32​
    否​
    佣金策略​
    1=整体固定抽佣​
    2=商品单独抽佣​
    1​
    .commission_ratio​
    string​
    否​
    抽佣比例,仅整体固定抽佣传递。万分位,例如1234表示12.34%​
    1234​
    .product_items​
    []​
    否​
    当前生效中的商品佣金信息。当入参 without_product_items 为 true 时不返回。​
    最多返回200个商品佣金。​
    ..product_id​
    string​
    否​
    商品id​
    1725647491732535​
    ..actual_price​
    string​
    否​
    商品售价​
    2000​
    ..commission_ratio​
    string​
    否​
    分佣比例,"1234" 表示分佣比例12.34%​
    300​
    ..product_status​
    i32​
    否​
    商品状态​
    1​

    响应示例

    // without_product_items = false { "data": { "product_items": [ { "actual_price": "10", "commission_ratio": "1900", "product_id": "1738315637900350", "product_status": 1 }, { "actual_price": "10", "commission_ratio": "1800", "product_id": "1738323521145982", "product_status": 1 }, { "actual_price": "20", "commission_ratio": "1700", "product_id": "1743305630547982", "product_status": 1 }, { "actual_price": "30", "commission_ratio": "1689", "product_id": "1741293139936271", "product_status": 1 }, { "actual_price": "10", "commission_ratio": "1001", "product_id": "1738313718124563", "product_status": 1 } ], "product_name": "代运营(开环)", "start_time": 1670469925, "status": 302, "description": "success", "account_id": "7102357172037617678", "charge_type": 2, "end_time": 1695787164, "merchant_name": "测试服务商5", "error_code": 0, "cooperation_content": 5, "create_time": 1670469397, "id": "7174603230893279290" }, "extra": { "now": 1670470067, "sub_description": "", "sub_error_code": 0, "description": "success", "error_code": 0, "logid": "202212081127470101410451500305053E" } }

    错误码

    HTTP 状态码
    错误码
    错误信息
    排查建议
    200​
    2190008​
    access_token无效​
    调用接口重新生成access_token​
    200​
    2100005​
    参数不合法​
    确认order_id是否合法;商品佣金比例是否在(0,80]的范围内​