淘宝买家订单列表、订单详情、订单物流 API 接口全攻略

一、接口概述

淘宝订单相关 API 接口是电商自动化的核心工具，为开发者提供订单数据管理与物流追踪能力。通过这些接口，可实现：

订单列表查询：批量获取指定时间范围内的订单信息，支持按状态（如待付款、已发货）、时间等条件筛选。

订单详情获取：通过订单 ID 获取买家信息、商品清单、支付状态及物流详情。

物流轨迹追踪：实时获取订单的物流状态及运输节点信息，支持多物流公司数据同步。

接口基于 HTTP 协议，支持 Python、Java 等多语言调用，响应数据以 JSON 格式返回，便于开发者集成与解析。

二、申请与准备流程

注册开发者账号

访问 c0b.cc/R4rbK2 ，获取账号。 小编:Taobaoapi2014 。

创建应用并获取凭证

在控制台创建新应用，生成 App Key 和 App Secret，作为接口调用的身份标识。

申请接口权限

根据需求申请以下接口权限：

订单列表：taobao.trades.sold.get（批量查询）或 taobao.trades.sold.search（条件搜索）。

订单详情：taobao.trade.fullinfo.get。

物流信息：taobao.logistics.trade.trackget。

提交企业资质（如营业执照），审核通过后生效。

三、Python 请求示例

以下为订单列表、订单详情、物流信息的 Python 调用示例，需替换 APP_KEY 和 APP_SECRET。

1. 订单列表查询

python

importrequestsimporttimeimporthmacimporthashlibimporturllib.parsedefgenerate_sign(params,app_secret):sorted_params=sorted(params.items(),key=lambdax:x[0])query_str=urllib.parse.urlencode(sorted_params)sign=hmac.new(app_secret.encode('utf-8'),query_str.encode('utf-8'),hashlib.md5).hexdigest().upper()returnsigndefget_order_list(app_key,app_secret):url="https://eco.taobao.com/router/rest"params={"method":"taobao.trades.sold.get","app_key":app_key,"timestamp":str(int(time.time())),"v":"2.0","format":"json","sign_method":"hmac","fields":"tid,status,total_fee,created","start_created":"2025-01-01 00:00:00","end_created":"2025-03-31 23:59:59","page_no":1,"page_size":20}params["sign"]=generate_sign(params,app_secret)response=requests.get(url,params=params)data=response.json()returndata.get("trades",{}).get("trade",[])# 使用示例 APP_KEY="your_app_key"APP_SECRET="your_app_secret"orders=get_order_list(APP_KEY,APP_SECRET)fororderinorders:print(f"订单号: {order['tid']}, 状态: {order['status']}")

2. 订单详情获取

python

defget_order_detail(app_key,app_secret,tid):url="https://eco.taobao.com/router/rest"params={"method":"taobao.trade.fullinfo.get","app_key":app_key,"timestamp":str(int(time.time())),"v":"2.0","format":"json","sign_method":"hmac","fields":"tid,status,total_fee,buyer_nick,shipping_address","tid":tid}params["sign"]=generate_sign(params,app_secret)response=requests.get(url,params=params)data=response.json()returndata.get("trade",{})# 使用示例 order_detail=get_order_detail(APP_KEY,APP_SECRET,"1234567890")print(f"买家昵称: {order_detail['buyer_nick']}, 总金额: {order_detail['total_fee']}")

3. 物流信息查询

python

defget_logistics_info(app_key,app_secret,tid,logistics_no):url="https://eco.taobao.com/router/rest"params={"method":"taobao.logistics.trade.trackget","app_key":app_key,"timestamp":str(int(time.time())),"v":"2.0","format":"json","sign_method":"hmac","fields":"company_name,logistics_trace","tid":tid,"logistics_code":logistics_no}params["sign"]=generate_sign(params,app_secret)response=requests.get(url,params=params)data=response.json()returndata.get("logistics",{})# 使用示例 logistics=get_logistics_info(APP_KEY,APP_SECRET,"1234567890","SF123456789")print(f"物流公司: {logistics['company_name']}, 状态: {logistics['logistics_trace'][0]['status']}")

通过合理使用淘宝订单 API 接口，开发者可高效实现订单管理、物流追踪等核心功能，为电商系统提供数据支持。建议定期查阅文档，及时跟进接口更新。如需进一步优化，可结合数据分析工具（如生意参谋）提升运营效率。