淘宝买家/卖家订单列表、订单详情、订单物流 API 接口全攻略-CRMEB社区

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

管理

编辑

删除

一、接口概述

淘宝订单相关 API 接口为开发者提供了获取订单数据、追踪物流状态的核心能力，支持以下三大功能：

订单列表查询：批量获取指定时间范围内的订单信息，支持按状态、时间等条件筛选。
订单详情获取：通过订单 ID 查询买家信息、商品清单、支付状态等详细数据。
物流轨迹追踪：实时获取订单的物流状态及运输节点信息。

二、申请与准备流程

注册与认证访问c0b.cc/R4rbK2 ，获取账号。小编:Taobaoapi2014 创建应用：在控制台创建新应用，获取 App Key 和 App Secret（接口调用凭证）。
权限申请申请目标接口权限：订单列表：taobao.trades.sold.get（批量查询）或 taobao.trades.sold.search（条件搜索）。订单详情：taobao.trade.fullinfo.get。物流信息：taobao.logistics.trade.trackget。提交资质审核（如企业营业执照），等待平台审批。

三、接口调用详解

1. 订单列表接口

请求方式：HTTP POST
核心参数：参数名说明示例值start_time订单创建开始时间2025-01-01 00:00:00end_time订单创建结束时间2025-01-31 23:59:59status订单状态（如已发货）TRADE_FINISHEDpage_no页码1page_size每页显示数量20
响应示例： json json 代码解读复制代码{ "total_count": 100, "orders": [ { "order_id": "1234567890", "buyer_name": "张三", "total_amount": 200.00, "status": "已发货" } ] }

2. 订单详情接口

请求方式：HTTP POST
核心参数：参数名说明示例值tid订单 ID1234567890
响应示例： json json 代码解读复制代码{ "order_id": "1234567890", "buyer_info": { "name": "张三", "phone": "13800138000" }, "product_list": [ { "product_name": "商品A", "quantity": 2, "price": 100.00 } ] }

3. 物流信息接口

请求方式：HTTP POST
核心参数：参数名说明示例值tid订单 ID1234567890logistics_no物流单号SF123456789
响应示例： json css 代码解读复制代码{ "company_name": "顺丰速运", "logistics_trace": [ { "time": "2025-01-16 08:00:00", "location": "XX市XX区集散中心", "status": "已收件" } ] }

四、代码示例（Python）

python

import requests
import time
import hmac
import hashlib
import urllib.parse
# 封装好的第三方数据商平台接口，复制链接获取测试。 
demo url=c0b.cc/R4rbK2　 wechat id:Taobaoapi2014
def generate_sign(params, app_secret):
    sorted_params = sorted(params.items(), key=lambda x: 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()
    return sign

def get_order_logistics(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)
    return response.json()

# 使用示例
app_key = "your_app_key"
app_secret = "your_app_secret"
tid = "1234567890"
logistics_no = "SF123456789"
result = get_order_logistics(app_key, app_secret, tid, logistics_no)
print(result)

五、注意事项

权限与频率免费版接口调用频率通常为 500 次 / 分钟，企业版可申请更高配额。物流接口需额外申请 logistics 类目权限。
数据安全敏感信息（如买家地址、电话）需加密传输，避免泄露。严格遵守《淘宝开放平台开发者协议》，禁止爬取非授权数据。
错误处理捕获错误码（如 10001 权限不足、10006 频率超限），实现重试机制。物流信息可能存在延迟，建议结合 last_modified 字段判断更新状态。
签名规范使用淘宝提供的 SDK 生成签名，确保参数排序和编码正确。

六、结语

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