### 使用 Python 调用 USPS API 查询快递更新 为了通过 Python 调用 USPS API 来获取运输状态更新，开发者需要遵循 USPS 提供的相关规则和流程[^1]。以下是实现此功能的关键部分： #### 1. 获取 USPS API 凭证 在使用 USPS API 前，必须注册并获得一个有效的用户名（User ID）。该凭证用于身份验证，并允许访问 USPS 的服务接口。 #### 2. 构建请求 URL 和 XML 数据结构 USPS Tracking API 需要发送 POST 请求到指定的端点地址 `https://secure.shippingapis.com/ShippingAPI.dll` 并附带特定格式的 XML 数据作为参数。XML 中应包含用户的认证信息以及待查询的追踪编号。 下面是一个简单的例子展示如何构建这样的请求: ```python import requests def track_package(tracking_number, user_id): url = 'https://secure.shippingapis.com/ShippingAPI.dll' xml_data = f""" <?xml version="1.0" encoding="UTF-8"?> <TrackFieldRequest USERID="{user_id}"> <TrackID ID="{tracking_number}"></TrackID> </TrackFieldRequest> """ params = { 'API': 'TrackV2', 'XML': xml_data.strip() } response = requests.get(url, params=params) return response.text ``` 上述函数接受两个参数：跟踪号 (`tracking_number`) 和 USPS 用户名 (`user_id`)。它会返回来自服务器的原始响应数据，通常也是 XML 格式的字符串。 #### 3. 解析返回的数据 由于 USPS 返回的结果通常是 XML 形式，因此可以利用像 ElementTree 这样的库解析这些数据以便进一步处理或显示给最终用户查看。 这里提供了一个基本的例子说明怎样提取关键的信息片段： ```python from xml.etree import ElementTree as ET def parse_track_response(xml_string): root = ET.fromstring(xml_string) summary_elements = root.findall('.//Summary') summaries = [] for elem in summary_elements: status = elem.find('Status').text if elem.find('Status') is not None else '' description = elem.find('Description').text if elem.find('Description') is not None else '' summaries.append({ 'status': status, 'description': description }) return summaries ``` 以上代码定义了另一个辅助方法用来解读由前一步骤取得的服务反馈内容，并将其转换成更易于理解的形式——即字典列表形式表示各个阶段的状态描述及其详情。