BioTech 开放平台文档
简体中文English
输入关键词搜索文档。

抖音精选联盟订单

分页查询抖音精选联盟订单，包含筛选、排序、响应字段和数据单位说明。

查看 Markdown在 ChatGPT 中打开在 Claude 中打开

接口信息

项目值
请求方法GET
请求 URLhttps://backend.biotech-mkt.com/openapi/v1/doudian/order/union-settlement-orders
接口路径/openapi/v1/doudian/order/union-settlement-orders
认证方式Bearer Access Token
权限要求接口需启用并授权给当前应用
频控按应用与接口配置
Acceptapplication/json

响应结果

发送请求后，HTTP 状态、耗时和响应内容会显示在这里。

分页查询平台已经同步入库的抖音精选联盟订单。

认证与授权

该接口需要 Access Token，并且必须由平台管理员完成接口登记、启用和应用授权。

请求参数

分页与排序

参数类型默认值说明
pageinteger1页码，从 1 开始
page_sizeinteger10每页记录数
order_bystringid排序字段，建议使用 id 或 update_time
order_by_directionstringdescasc 或 desc

文本筛选

以下参数使用包含匹配：

参数说明
order_id订单号
shop_name商家名称
product_id商品 ID
product_name商品名称
product_img商品图片 URL
media_type带货体裁代码
flow_point订单状态代码
appApp 名称
author_buyin_id达人百应 ID
author_short_id作者抖音号
author_account作者账号昵称
distributor_buyin_id独立抖客百应 ID
distributor_name独立抖客昵称

精确与多值筛选

以下参数传单个值时使用精确匹配；以 field[]=a&field[]=b 传多个值时使用集合匹配：

参数说明
media_id视频或直播间 ID
app_id内容端 App ID
buyer_app_id购买端 App ID
shop_id店铺 ID
item_num商品数量
total_pay_amount订单支付金额，单位元
pay_goods_amount预估参与结算金额，单位元
settled_goods_amount实际参与结算金额，单位元
estimated_commission达人预估佣金，单位元
real_commission达人实际佣金，单位元
estimated_total_commission预估总佣金，单位元
shop_estimated_commission商家预估佣金支出，单位元
shop_real_commission商家实际佣金支出，单位元
ads_estimated_commission独立抖客预估推广费，单位元
ads_real_commission独立抖客实际推广费，单位元
settled_tech_service_fee平台结算技术服务费，单位元
commission_rate达人佣金率，百分比值
ads_promotion_rate独立抖客推广费率，百分比值
tenant_id租户 ID
dept_id部门 ID
created_by创建者 ID
updated_by更新者 ID

时间筛选

以下参数传单个值时精确匹配；传两个数组值时按闭区间筛选：

参数说明
pay_success_time付款时间
confirm_time确认收货时间
settle_time结算时间
refund_time退款时间
update_time联盟侧订单更新时间
created_at本地记录创建时间

建议使用 YYYY-MM-DD HH:mm:ss 格式，并通过 URL 编码传递空格。

请求示例

Terminal window
curl --get "https://backend.biotech-mkt.com/openapi/v1/doudian/order/union-settlement-orders" \
  --header "Authorization: Bearer $OPENAPI_ACCESS_TOKEN" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=20" \
  --data-urlencode "shop_id=10001" \
  --data-urlencode "flow_point=SETTLE" \
  --data-urlencode "update_time[]=2026-08-01 00:00:00" \
  --data-urlencode "update_time[]=2026-08-26 23:59:59"

应答字段

data.list 中字段随当前数据表记录序列化返回；金额和费率等 Decimal 字段通常表现为保留两位小数的字符串。data.total 为符合筛选条件的记录总数。

响应结构

字段返回类型说明
codeinteger业务状态码，成功时为 200
messagestring响应消息
dataobject分页响应数据
data.listarray<object>当前页订单记录
data.totalinteger符合筛选条件的订单记录总数

订单与平台字段

字段返回类型说明
idinteger本地记录 ID
order_idstring订单号
shop_idinteger店铺 ID
shop_namestring商家名称
product_idstring商品 ID
product_namestring商品名称
product_imgstring商品图片 URL
item_numinteger商品数量
media_idinteger视频或直播间 ID
media_typestringshop_list、video、live 或 others
media_type_textstring带货体裁中文文本
appstring内容端 App 名称
app_idinteger1128 抖音、1112 火山、32 西瓜、13 头条
app_id_textstring内容端 App 中文文本
buyer_app_idinteger购买端 App ID，另支持 2329 抖音极速版
buyer_app_id_textstring购买端 App 中文文本
extrastring上游其他信息

状态与时间字段

字段返回类型说明
flow_pointstringPAY_SUCC、REFUND、SETTLE 或 CONFIRM
flow_point_textstring支付完成、退款、结算或确认收货
pay_success_timestring/null付款时间
confirm_timestring/null确认收货时间
settle_timestring/null结算时间
refund_timestring/null退款时间
update_timestring/null联盟侧订单更新时间
created_atstring/null本地创建时间
updated_atstring/null本地更新时间

金额与费率字段

同步入库时，上游“分”金额会除以 100 转为“元”，上游万分比费率会除以 100 转为百分比值。例如上游金额 12345 返回 123.45 元，上游费率 450 返回 4.50。

字段返回类型说明
total_pay_amountstring订单支付金额，元
pay_goods_amountstring预估参与结算金额，元
settled_goods_amountstring实际参与结算金额，元
estimated_commissionstring达人预估佣金收入，元
real_commissionstring达人实际佣金收入，元
estimated_total_commissionstring预估总佣金，元
shop_estimated_commissionstring商家预估佣金支出，元
shop_real_commissionstring商家实际佣金支出，元
ads_estimated_commissionstring独立抖客预估推广费，元
ads_real_commissionstring独立抖客实际推广费，元
settled_tech_service_feestring平台结算技术服务费，元
commission_ratestring达人佣金率，百分比值
ads_promotion_ratestring独立抖客推广费率，百分比值
colonel_estimated_commissionstring团长预估服务费，元
colonel_real_commissionstring团长结算服务费，元
colonel_commission_ratestring团长服务费率，百分比值

作者、抖客与团长字段

字段返回类型说明
author_buyin_idstring达人百应 ID
author_short_idstring作者抖音号
author_accountstring作者账号昵称
aweme_idstring抖音 UID
distributor_buyin_idstring独立抖客百应 ID
distributor_namestring独立抖客昵称
colonel_activity_idstring团长活动 ID
colonel_institution_idstring团长机构 ID
colonel_institution_namestring团长机构名称
colonel_colonel_buyin_idstring团长百应 ID
tenant_idinteger租户 ID
dept_idinteger部门 ID
created_byinteger/null创建者 ID
updated_byinteger/null更新者 ID

数据时效

该接口读取平台已经同步入库的数据，不会在请求时实时调用抖店。数据更新时间以记录的 update_time 和平台同步任务状态为准。

应答示例

json
{
  "code": 200,
  "message": "成功",
  "data": {
    "list": [
      {
        "id": 101,
        "order_id": "U202608260001",
        "shop_id": 10001,
        "shop_name": "示例店铺",
        "product_id": "90001",
        "product_name": "示例商品",
        "item_num": 1,
        "media_type": "video",
        "media_type_text": "视频",
        "flow_point": "SETTLE",
        "flow_point_text": "结算",
        "total_pay_amount": "123.45",
        "commission_rate": "4.50",
        "pay_success_time": "2026-08-20 10:00:00",
        "update_time": "2026-08-26 12:00:00"
      }
    ],
    "total": 1
  }
}

错误码与频控

该接口可能返回 401、403、404、405、429 或 503。频控按“应用 ID + 接口 ID”独立计数；具体处理方式和响应头见错误与频控。

最后更新于 2026年8月27日