合作详情查询
收藏
我的收藏根据订单 ID 查询合作详情,仅支持开环订单
使用限制
无
接口说明
无
基本信息
HTTP URL | ||||
HTTP Method | GET | |||
申请权限 | 代运营合作 | |||
权限要求 |
|
请求头
参数 | 描述 | 必须 |
Content-Type | application/json | 是 |
access-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]的范围内 |