在实际项目中，开发者经常面临以下痛点：API 文档不够直观、返回数据结构混乱、错误码难以定位、还有频繁的超时或限流导致程序不稳定。这篇文章用 Python 示例一步步演示如何调用电价 API，获取工商业分时电价 JSON。并将峰谷时段、电价、单位和更新时间解析为程序可直接使用的数据结构。相同的接入思路一样适用于现货电价、最近电价和实时电价 API。老实说，

准备工作与注意事项

以下示例中的接口地址、API Key 和返回数据均为演示用。不过，正式接入前，请务必参考实际 API 文档。确认请求方法、必填参数还有响应字段。

请求示例

import requests
API_BASE = "https://api.example.com/v1"
API_KEY = "YOUR_TRIAL_API_KEY"
def get_tou_price:
"""
调用分时电价接口。说到参数，province - 省份，例如 "浙江"
month - 查询月份，格式 "YYYY-MM" 或 "-" 表示最新
voltage_level - 电压等级，默认 "10kV"
"""
url = f"{API_BASE}/electricity-prices/tou"
params = {
"province": province,"month": month,"voltageLevel": voltage_level
}
headers = {
"Authorization": f"Bearer {API_KEY}","Accept": "application/json"
}
# 超时时间设置为 5 秒，防止因网络波动导致阻塞
response = requests.get
response.raise_for_status # 若返回非 2xx。将抛出异常
return response.json
if __name__ == "__main__":
data = get_tou_price
print

返回 JSON 示例

{
"province": "浙江","month": "-","voltageLevel": "10kV","periods":,"updatedAt": "2024-08-12T10:15:30+08:00"
}

将 JSON 转换为业务友好字典

业务程序通常需要根据时间匹配对应的电价，这里提供一个把时段信息标准化的函数。

from datetime import datetime
def parse_time:
"""将 'HH:mm' 字符串转为 time 对象"""
return datetime.strptime.time
def normalize_periods:
"""
将 API 返回的 periods 列表转换为内部统一结构：
"""
result =
for item in api_data.get:
result.append({
"type" : item,"start": parse_time,“end” : parse_time。“price”: float,“unit” : item
})
return result
# 示例调用
if __name__ == "__main__":
raw = get_tou_price
periods = normalize_periods
print

错误处理——摆脱“只会抛异常”的尴尬

生产环境中直接使用 requests.get 并靠 .raise_for_status 捕获异常往往不足以满足运维需求。下面的包装函数展示了常见错误码的细分处理，还有对超时和限流的容错策略。

def safe_get_tou_price:
至于try，return get_tou_price
except requests.exceptions.Timeout:
# 网络超时建议记录日志并返回统一错误码
return {"error":"REQUEST_TIMEOUT"}
except requests.exceptions.HTTPError as e:
status = e.response.status_code
if status == 404:
return {"error":"PRICE_NOT_FOUND"} # 数据不存在或未发布
if status == 429:
return {"error":"RATE_LIMITED"} # 调用频率受限
if status == 400:
return {"error":"INVALID_PARAMETERS"} # 参数错误。需要回查文档
# 未知 HTTP 错误，统一返回
return {"error":"HTTP_ERROR","status":status}
except Exception as ex:
# 捕获所有不可预期异常，防止服务崩溃
return {"error":"UNKNOWN_EXCEPTION","msg":str}

接入建议

1. 先用测试 Key 验证字段：确保所有必填参数都能得到预期响应，再切换正式环境。老实说，
2. 对比人工维护的数据：利用本地历史数据做一次完整性校验。快速发现接口字段变更，
3. 建立本地缓存：将最近一次成功请求的 JSON 写入 Redis/文件程序，避免页面高并发时每次都远程调用。
4. 记录 updatedAt。
5. 统一日志与告警：把上述错误码写入结构化日志。配合监控网站设置告警阈值，快速定位“超时”“限流”等突发问题。
6. 重试机制：对超时或 5xx 错误进行指数退避重试，降低瞬时网络波动带来的影响。

常见问题 FAQ

Q：Python 调用电价 API 必须传哪些参数？

A：最基本的参数包括省份、查询月份和电压等级。如果是现货电价，还需额外提供行业市场、日期、价格类型还有时间粒度或节点信息等。不过，

Q：获取到 JSON 后应该如何存储才方便后续分析？其实，

A：推荐采用“双写”方式：① 将原始 JSON 保存到对象存储或日志库。以便审计追溯，② 将解析后的标准化表写入关系型数据库或时间序列库，用于 EMS、储能测算、售电分析和报表查询。

Q：调用失败时可以直接抛异常吗？

A：在生产程序中不建议把原始异常暴露给终端使用者。说起来，应当捕获并转化为业务可识别的错误码，如上文所示。同时结合缓存策略、自动重试还有统一日志上报，以提高程序鲁棒性。

Q：如何判断接口返回的数据是否是最新的？

A：大多数电价 API 都会在响应体中提供 "updatedAt" 字段。将该时间与本地缓存时间做比较，如果差值超过设定阈值，则主动刷新缓存；否则直接使用已缓存的数据即可。

Q：遇到限流 时怎么办？

A：限流属于可预期错误。应在代码层面实现退避策略，例如先等待 1 秒，再尝试一次；若仍然被拒绝，则记录告警并返回统一的 “RATE_LIMITED”。长期来看，可通过申请更高配额或采用分布式调用池来根本解决。

*以上示例仅供学习参考，实际生产环境请结合官方文档并做好安全审计。*