通过 Zyla API Hub 使用 Postman 测试美国 ZIP 代码的油价

您需要在本周的应用程序中显示特定美国 ZIP 代码的油价，证明它在 Postman 中有效，然后发布。在本文结束时，您将通过 Zyla API Hub 的美国 ZIP 代码油价 API 按 ZIP 和燃料类型查询真实的加油站价格，解析代码中的响应，并了解如何在您拥有 ID 时提取加油站详细信息。

此 API 的功能及使用时机

美国 ZIP 代码油价 API 返回给定美国 ZIP 代码和燃料类型的最新油价。它旨在用于开发者工作流程，您需要快速查找价格以支持预算、成本比较或结账流程（例如，估算交付、拼车或车队路线的燃料成本）。响应包括：

插图：通过 Zyla API Hub 使用 Postman 测试美国 ZIP 代码的油价

ZIP 和油品类型上下文
货币
聚合（平均值、最低值）和每个加油站条目（名称、地址、价格）

典型用例包括：

显示某个地点附近最便宜的普通油的消费者价格比较小部件
根据当地油价估算旅行成本的财务和运营工具
预测每位司机 ZIP 的每月燃料支出的费用和预算应用
根据 ZIP 显示实时燃料附加费的电子商务或物流计算器

该 API 可在 Zyla API Hub 上使用，这是一个拥有超过 10,000 个公共 API 的市场，采用订阅 + 配额模型。一个账户，一个密钥，跨您的技术栈保持一致的身份验证和使用跟踪。

在 Zyla API Hub 上开始

要调用此 API，请打开 Zyla API Hub 上的列表页面，点击订阅（或在可用时开始免费试用），并获取您的 API 密钥。Zyla 使用订阅 + 配额计费（不是按调用计费）。没有免费计划。对于第一个 API，您通常会看到 7 天试用或 50 次请求选项——请查看 API 页面以获取当前访问选项和定价。

身份验证在所有调用中都是相同的：在授权头中包含您的密钥，格式为 Bearer YOUR_API_KEY。

您可以调用的端点

该 API 通过 Hub 暴露两个端点。获取价格端点是您将用于按 ZIP 和燃料类型查询价格的端点。当您需要更深入的加油站详细信息时，请使用带有您通过获取价格获得的加油站 ID 的加油站数据。

1) 获取价格

方法：GET
URL： https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices
描述：传入您选择的 ZIP 代码和您想要检查的燃料类型。API 返回给定 ZIP 中相关加油站的价格。
查询参数：
- zip（数字，必需）：例如，90002
- type（字符串，必需）：例如，普通

可复制的 curl（官方示例）：

curl -s -X GET "https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例 JSON 响应：

{
"status": "success",
"zip": "77099",
"gas_type": "regular",
"currency": "USD",
"gas_prices": [
{
"average": "$2.59",
"lowest": "$2.18"
},
{
"station": "Spark",
"address": "13435 W Bellfort Ave Houston, TX",
"price": "$2.29"
},
{
"station": "US Gas",
"address": "12697 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "CITGO",
"address": "13150 Bissonnet St Houston, TX",
"price": "$2.34"
},
{
"station": "Swift",
"address": "10841 Bissonnet St Houston, TX",
"price": "$2.32"
},
{
"station": "Shop N Go",
"address": "12222 Bissonnet St Houston, TX",
"price": "$2.35"
},
{
"station": "Murphy USA",
"address": "9450 W. Sam Houston Pkwy. S. Houston, TX",
"price": "$2.37"
},
{
"station": "Valero & Circle K",
"address": "11200 Wilcrest Dr Houston, TX",
"price": "$2.45"
},
{
"station": "Best Food",
"address": "13102 Bissonnet St Houston, TX",
"price": "$2.45"
},
{
"station": "Valero",
"address": "11249 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "Fuel Depot",
"address": "11575 Bissonnet St Houston, TX",
"price": "$2.29"
},
{
"station": "Exxon",
"address": "12790 S Dairy Ashford St Houston, TX",
"price": "$2.53"
}
]
}

从此有效载荷中读取内容：

status：成功指示字符串
zip：ZIP 代码上下文（字符串）
gas_type：您请求的燃料类型（例如，普通）
currency：美元
gas_prices：一个数组，首先是聚合（平均值、最低值），然后是加油站级别的条目（加油站、地址、价格）

单位和格式：价格是带有前导“$”的字符串，表示每加仑美元。货币明确为美元。

2) 加油站数据

方法：GET
URL： https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/23307/station-data
描述：返回单个加油站的详细信息。您必须指定一个加油站 ID。您可以从获取价格端点获得该 ID。
参数：在 Hub 列表中没有记录的参数，除了需要加油站 ID。使用如下所示的授权。

注意：由于列表未将加油站 ID 记录为查询参数名称或路径变量，因此在高层次上将此端点视为“需要 ID”，并参考 API 页面以了解如何在您的用例中传递它。请勿发明参数名称。

示例加油站数据响应：

此有效载荷提供您可以在详细视图中显示的加油站元数据：标准化地址、坐标、联系信息、状态、评级、支持的燃料和附近的加油站。货币和 price_unit 确认定价上下文为每加仑美元。

在 Postman 中快速测试

逐步指南

在 Postman 中创建一个新的 GET 请求。
输入 URL：
https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular
在 Headers 选项卡中，添加：
- 键：Authorization
- 值：Bearer YOUR_API_KEY
发送请求。您应该收到一个 JSON 有效载荷，类似于上面的官方示例。

提示：注意 gas_prices 中首先出现的“平均”和“最低”条目。然后，迭代加油站项目以获取名称、地址和价格，以按价格排序呈现列表。

您可以粘贴到应用程序中的代码

Python（requests）示例

此脚本调用 ZIP 90002 和燃料类型“普通”的获取价格，然后按出现顺序打印聚合价格和前 3 个加油站。

import os
import requests

API_KEY = os.getenv("ZYLALABS_API_KEY", "YOUR_API_KEY")
url = "https://zylalabs.com/api/4805/gas-prices-in-usa-by-zip-code/5987/get-prices?zip=90002&type=regular"
headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(url, headers=headers, timeout=30)
resp.raise_for_status()
data = resp.json()

status = data.get("status")
zip_code = data.get("zip")
gas_type = data.get("gas_type")
currency = data.get("currency")
items = data.get("gas_prices", [])

# 从第一个元素提取聚合（如果存在）
average_price = None
lowest_price = None
if items and "average" in items[0]:
average_price = items[0].get("average")
lowest_price = items[0].get("lowest")

print(f"状态: {status}")
print(f"ZIP: {zip_code} 类型: {gas_type} 货币: {currency}")
print(f"平均: {average_price} 最低: {lowest_price}")

# 迭代加油站条目（跳过第一个聚合项目）
stations = items[1:] if items else []
for s in stations[:3]:
name = s.get("station")
addr = s.get("address")
price = s.get("price")
print(f"- {name} | {addr} | {price}")

节省您时间的注意事项：

价格是带有货币符号的字符串。如果您需要数字比较，请小心地去掉“$”并转换为浮点数。
gas_prices 中的第一个对象包含聚合；将其与加油站条目分开处理。
currency 是美元。对于财务工具，您可以在计算成本时将其视为规范单位。

生产集成细节

身份验证：每个请求的 Authorization: Bearer YOUR_API_KEY。
单位：价格是每加仑美元。currency 是“USD”。加油站数据提供的 price_unit 是“dollars_per_gallon”。
缓存：列表未记录缓存头或刷新间隔。如果您频繁调用，请考虑按 ZIP 和燃料类型进行短期缓存，以减少冗余请求和延迟。
分页：在列表中未记录。每次调用预期一页。
超时：设置合理的客户端超时（例如，Python 示例中的 30 秒）。
错误处理：检查应用程序逻辑中的状态字段，并在适当的情况下处理非 2xx HTTP 响应并重试。

您本周可以发布的以财务为先的用例

旅行估算器：将路线距离（英里）乘以车辆 MPG 和当地“平均”价格，以估算每次旅行或工作中的燃料成本。
报销政策引擎：通过与当天和 ZIP 的“最低”或附近加油站价格进行比较，验证司机提交的燃料费用。
动态附加费：对于交付或搬家服务，计算与预订时提货 ZIP 的当地“平均”油价挂钩的附加费。
预算仪表板：对于每位司机的家庭 ZIP，每周提取“普通”价格并预测每个车辆类别的每月支出。

通过 MCP 从 AI 代理调用

如果您使用 AI 编码工具（Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端）进行构建，您可以通过 Zyla 的 MCP 端点路由调用。在初始化 MCP 工具时，将您的 Zyla API 密钥作为查询参数提供：

端点： https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY

请参阅 MCP 页面以获取客户端设置详细信息。相同的 Authorization: Bearer 语义适用于您的代理向 Hub 端点发出的请求。

Postman 和 CI 提示

环境变量：将 YOUR_API_KEY 存储在环境中，并在授权头中引用它，以避免在请求中复制粘贴错误。
ZIP 覆盖测试：为您服务的每个市场添加一个请求（例如，90002、75201、33101）。检查 gas_prices 是否非空。
解析断言：在 Postman 测试中，断言 currency === "USD"，并且第一个 gas_prices 元素包含 average 和 lowest 键。
掩码字符串：如果您将价格字符串转换为浮点数，请确保去掉美元符号，并在显示计算总数时一致地处理四舍五入。