当前位置： API文档

api_trade_live_extend_query.php（查询直播主播信息）

¥基础

1.接口说明

1.1 接口描述：获取租户系统内平台订单的直播信息扩展
1.2 适用版本：网页版
1.3 时间跨度：开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-30 23:59:59，建议根据获取数据量的多少适当减小时间跨度。

2.调用场景

2.1 举例说明：SAP、线下ERP、SRM、SCM等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://openapi.ali.huice.cc/openapi/api_trade_live_extend_query.php
正式环境https://openapi.huice.com/openapi/api_trade_live_extend_query.php

3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
时间戳timestampint
是北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果，签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度
必须描述
tid原始单号tid

原始单号 有原始单号可以不传时间
start_time开始时间start_time

修改起始时间
end_time结束时间end_time

修改结束时间
shop_id店铺idshop_id

代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
shop_no店铺编号shop_no

代表店铺所有属性的唯一编号，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
分页大小page_sizepage_size
否每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为100，使用实例单击这里
页号page_nopage_no
否 页号，不传默认从0页开始

4.响应参数

4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述

  4.2 业务响应参数

名称字段类型长度
必须描述
总条数total_countin11

直播数据列表listdata[]
是响应参数的数据节点

  list

名称字段类型长度
必须描述
idrec_idbigint


平台idplatform_idint


原始单号tidvarchar


原始子单号oidvarchar


店铺IDshop_idint

代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看 
店铺编号shop_idvarchar

代表店铺所有属性的唯一编号，用于店铺区分，在旺店通ERP【绑定店铺】界面查看 
状态statusint

0 已处理 1 待处理 2 获取失败

平台主播id

role_idvarchar


预估达人佣金率commission_ratedecimal(19,4)


预估达人佣金commissiondecimal(19,4)


类型 other_flagsint

1 自营 2 平台分销 4 直播 8 短视频 16 店铺自卖

达人昵称 

role_namevarchar


直播间IDroom_idvarchar


直播间名称room_namevarchar


短视频IDvideo_idvarchar


团长IDactivity_user_idvarchar


团长昵称activity_user_namevarchar


团长服务费率investment_promotion_ratedecimal(19,4)


团长服务费金额investment_promotion_amountdecimal(19,4)


流量渠道flow_toolsvarchar


流量类型flow_typevarchar

抖店（ 1：广告 |2：非广告|）
商家预估支出shop_estimated_commissiondecimal(19,4)


备注remarkvarchar


备用字段1reserve_field1decimal(19,4)


备用字段2reserve_field2varchar


备用字段3reserve_field3varchar


修改时间modifieddatetime


数据创建时间createddatetime


下单时间order_timedatetime


支付时间pay_timedatetime


完成时间end_timedatetime


商品IDgoods_idvarchar


规格IDspec_idvarchar


5.请求示例

PHP
//查询直播主播信息
<?php
	require_once("../WdtClient.php");
	$c = new WdtClient;
        $c->sid = '';
	$c->appkey = '';
	$c->appsecret = '';
        $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/api_trade_live_extend_query.php';

	
	$c->putApiParam('start_time', '2026-03-01 15:50:06');
	$c->putApiParam('end_time', '2026-03-30 15:50:07');
	$c->putApiParam('page_no', '0');
	$c->putApiParam('page_size', '100');
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
C#
python

6.响应示例

   6.1 正常响应示例 

JSON
{
	"code": 0,
	"message": "",
	"total_count": 1,
	"list": [{
		"rec_id": "2810567127172382745",
		"tenant_id": "haijun",
		"platform_id": "69",
		"tid": "6925171279519448701",
		"oid": "6925171279519448701",
		"shop_id": "1011",
		"shop_no": "270120e204400019",
		"status": 0,
		"role_id": "0",
		"commission_rate": "0.0000",
		"commission": "0.0000",
		"other_flags": 17,
		"role_name": "",
		"room_id": "0",
		"room_name": "",
		"video_id": "",
		"activity_user_id": "",
		"activity_user_name": "",
		"investment_promotion_rate": "0.0000",
		"investment_promotion_amount": "0.0000",
		"flow_tools": "其他",
		"flow_type": "2",
		"shop_estimated_commission": "0.0000",
		"remark": "",
		"reserve_field1": "0.0000",
		"reserve_field2": "{"type":8,"update":1774600088}",
		"reserve_field3": "",
		"modified": "2026-03-28 06:10:20",
		"created": "2026-03-27 16:30:20",
		"order_time": "2026-03-27 16:22:49",
		"pay_time": null,
		"end_time": null,
		"goods_id": "3810918930722194273",
		"spec_id": "3652000618977026"
	}]
}

   6.2 异常响应示例

JSON
{
    "code": 2900,
    "message": "时间范围与订单编号不能全部为空"
}







常用工具