在Cursor中开发Python项目调用第三方API需四步：确认API文档四项关键参数；安装requests和python-dotenv；配置.env文件并启用Auto-load；编写带超时与异常处理的API调用函数，支持同步或异步集成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Cursor中开发Python项目时，直接调用第三方API常因环境隔离、密钥管理或异步阻塞问题导致本地调试失败、部署后超时或认证报错。
确认API文档与基础依赖
打开目标API的官方文档（如微信对话开放平台、OpenWeather、聚合数据），重点核对四项：请求URL、HTTP方法（GET/POST）、认证方式（API Key放query还是Header）、参数格式（query string / JSON body）。这一步跳过会导致后续所有请求返回401或400，且错误信息模糊难定位。
在Cursor左下角终端中执行：pip install requests python-dotenv。注意不要只装requests——python-dotenv用于安全加载.env文件，避免密钥硬编码被提交到Git。
配置环境变量防止密钥泄露
在项目根目录新建.env文件，写入：WEATHER_API_KEY=your_actual_key_hereCQHTTP_URL=http://127.0.0.1:5700
立即学习“Python免费学习笔记（深入）”；
【必须在Cursor设置中启用环境变量自动加载】：点击Cursor右上角齿轮→Settings→Extensions→Python→勾选“Auto-load .env files”。不开启此选项，os.getenv("WEATHER_API_KEY")将始终返回None，且无任何提示。
在Python文件顶部添加：
from dotenv import load_dotenv<br>load_dotenv()
编写带超时与异常隔离的API调用函数
在utils/api_client.py中创建统一入口：
第一步：定义基础请求函数，强制拆分连接与读取超时
第二步：捕获Timeout、ConnectionError、HTTPError三类异常，分别返回不同状态码
第三步：对4xx/5xx响应不直接抛出，而是解析response.json().get("error")字段供前端展示
示例代码：
import requests<br>import os<br>def call_weather_api(city):<br> url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={os.getenv('WEATHER_API_KEY')}&units=metric"<br> try:<br> resp = requests.get(url, timeout=(3, 10))<br> resp.raise_for_status()<br> return {"success": True, "data": resp.json()}<br> except requests.exceptions.Timeout:<br> return {"success": False, "error": "服务响应超时，请稍后重试"}<br> except requests.exceptions.ConnectionError:<br> return {"success": False, "error": "无法连接到天气服务"}<br> except requests.exceptions.HTTPError:<br> return {"success": False, "error": f"API返回错误：{resp.status_code}"}<br> except Exception:<br> return {"success": False, "error": "未知错误"}
在Flask路由中安全集成API调用
方法一：同步调用（适合低频、非核心接口）
直接在@app.route函数内调用call_weather_api("shanghai")，返回JSON响应。Cursor调试时可实时看到终端日志和HTTP状态码。
方法二：异步封装（避免阻塞主线程）
安装httpx：pip install httpx
改用async def + await httpx.AsyncClient().get()，尤其适用于高并发场景下的短信或支付回调。
注意：Flask原生不支持async视图，需搭配flask-async扩展或改用FastAPI——Cursor对FastAPI的语法高亮和调试支持更完整。
