从零开始：在 PyCharm 中调用 API 接口获取数据全指南

原创于 2025-07-23 13:49:34 发布 · 861 阅读

CC 4.0 BY-SA版权

文章标签：

从零开始：在 PyCharm 中调用 API 接口获取数据全指南

在数据驱动的时代，调用 API 接口获取数据已成为开发者的必备技能。无论是获取天气信息、股票行情，还是对接第三方服务，API 都像一座桥梁，让程序能够灵活获取外部数据。本文将以 PyCharm 为开发环境，通过具体案例讲解 API 调用的完整流程，从基础概念到实战代码，帮你快速掌握这一核心技能。

一、API 基础：认识接口调用的核心要素

API（应用程序编程接口）是不同软件之间交互的规则，简单来说，就是一个允许外部程序获取数据的 “通道”。调用 API 获取数据的过程，类似于在浏览器中输入网址访问网页，只不过 API 返回的是结构化数据（通常为 JSON 格式），而非可视化页面。

核心要素：

请求地址（URL）：API 的访问路径，如 “https://api.exam ple .com/we ather”。

请求方法：最常用的是 GET（获取数据）和 POST（提交数据），获取数据主要用 GET。

参数：传递给 API 的额外信息，如 “城市 ID”“日期” 等，可放在 URL 后（GET 方法）或请求体中（POST 方法）。

请求头（Headers）：包含身份验证、数据格式等信息，部分 API 需要在请求头中添加 “API 密钥” 验证身份。

响应：API 返回的数据，通常为 JSON 格式，包含状态码（如 200 表示成功，404 表示地址错误）和具体内容。

例如调用天气 API 时，完整的请求可能是：https://api.weatherapi.com/v1/current.json?key=你的密钥&q=北京，其中key是验证参数，q是查询的城市名。

二、准备工作：安装工具与获取 API 密钥

在 PyCharm 中调用 API 需要用到处理网络请求的库，最常用的是requests（简洁易用）和urllib（Python 内置库）。本文以requests为例，步骤如下：

安装 requests 库：

打开 PyCharm 的 Terminal面板（View→Tool Windows→Terminal），输入命令：

pip install requests

安装完成后，在代码中通过import requests导入即可使用。

获取 API 密钥：

多数公开 API 需要注册获取密钥（key），以 “聚合数据” 的天气 API 为例：

- 访问聚合数据官网（www.juhe.cn），注册账号并申请 “天气查询 API”。

- 申请通过后，在个人中心获取 “API 密钥（key）”，这是调用接口的身份凭证。

部分 API 提供免费额度（如每日有限次调用），适合学习使用。测试时可先使用公开的免费 API（如 “JSONPlaceholder” 的测试接口，无需密钥），避免因权限问题阻碍学习。

三、基础实战：用 requests 库调用 GET 接口

以 “JSONPlaceholder” 的测试接口（https://jsonplaceholder.typico de.co m/pos ts）为例，该接口返回模拟的文章数据，无需密钥，适合新手练习。

步骤 1：创建项目与文件

在 PyCharm 中新建项目 “api_demo”，右键项目文件夹选择 “New→Python File”，命名为 “get_data.py”。

步骤 2：编写基础调用代码

import requests

# API请求地址

url = "https://jsonplaceholder.typicode.com/posts"

# 发送GET请求

response = requests.get(url)

# 打印响应状态码（200表示成功）

print("状态码：", response.status_code)

# 解析JSON响应数据

data = response.json()

# 打印前3条数据

print("\n前3条文章数据：")

for item in data[:3]:

print(f"标题：{item['title']}")

print(f"内容：{item['body'][:50]}...") # 只显示前50个字符

print("---")

代码解析：

requests.get(url)发送 GET 请求，返回的response对象包含服务器响应的所有信息。

response.status_code获取状态码，200 表示请求成功，4xx 表示客户端错误（如参数错误），5xx 表示服务器错误。

response.json()将 JSON 格式的响应内容转换为 Python 字典 / 列表，方便后续处理。

运行代码（右键→Run 'get_data'），控制台会输出状态码和前 3 条文章数据，表明 API 调用成功。

四、带参数与请求头：调用需要验证的 API

多数实际 API 需要传递参数和验证信息，以聚合数据的天气 API 为例，演示带参数和请求头的调用方法。

步骤 1：分析 API 文档

聚合数据的天气 API 请求地址为 “http://apis.juhe .cn/si mpleW eathe r/que ry”，需要的参数：

key：API 密钥（必填）。

city：城市名（如 “北京”，必填）。

请求头需指定数据格式为 “application/json”。

步骤 2：编写带参数的调用代码

import requests

# API请求地址

url = "http://apis.juhe.cn/simpleWeather/query"

# 请求参数

params = {

"key": "你的API密钥", # 替换为实际申请的密钥

"city": "上海"

}

# 请求头

headers = {

"Content-Type": "application/json"

}

# 发送带参数和请求头的GET请求

response = requests.get(url, params=params, headers=headers)

# 检查请求是否成功

if response.status_code == 200:

data = response.json()

# 解析返回数据（根据API文档的结构提取信息）

if data["error_code"] == 0: # API内部的成功标识

weather = data["result"]["realtime"]

print(f"城市：{params['city']}")

print(f"温度：{weather['temperature']}℃")

print(f"天气：{weather['info']}")

print(f"风向：{weather['direct']}")

else:

print("API返回错误：", data["reason"])

else:

print("请求失败，状态码：", response.status_code)

代码解析：

params参数会自动拼接到 URL 后，形成 “url?key=xxx&city = 上海” 的完整地址。

部分 API 将密钥放在请求头中（如headers={"Authorization": "Bearer 你的密钥"}），需根据具体文档调整。

API 返回数据的结构需参考官方文档，例如聚合数据的天气信息嵌套在result→realtime中，需逐层提取。

若运行时提示 “错误码 10012”，通常是密钥错误或未实名认证，需检查密钥是否正确或完成平台认证。

五、处理响应数据：解析与存储

API 返回的JSON 数据需要解析、筛选后才能用于后续开发，常见操作包括提取关键字段、转换格式、存储到文件等。

示例：提取并保存数据到 JSON 文件

以下代码调用文章 API，提取标题和作者信息，保存到本地文件：

import requests

import json # 用于处理JSON文件

url = "https://jsonplaceholder.typicode.com/posts"

response = requests.get(url)

data = response.json()

# 提取关键字段

filtered_data = []

for item in data:

# 只保留需要的字段

filtered_item = {

"id": item["id"],

"标题": item["title"],

"作者ID": item["userId"]

}

filtered_data.append(filtered_item)

# 保存到JSON文件

with open("posts_data.json", "w", encoding="utf-8") as f:

# ensure_ascii=False确保中文正常显示

json.dump(filtered_data, f, indent=2, ensure_ascii=False)

print("数据已保存到posts_data.json")

运行后，项目目录会生成 “posts_data.json” 文件，包含筛选后的结构化数据。若需保存为 Excel，可使用pandas库（需安装：pip install pandas openpyxl）：

import pandas as pd

# 将列表转换为DataFrame

df = pd.DataFrame(filtered_data)

# 保存为Excel

df.to_excel("posts_data.xlsx", index=False)

print("数据已保存到posts_data.xlsx")

六、错误处理：让程序更稳健

网络请求可能因网络故障、参数错误等原因失败，需添加错误处理机制，避免程序崩溃。

完善的错误处理代码：

import requests

from requests.exceptionsimport RequestException # 捕获请求异常

def get_api_data(url, params=None):

try:

# 设置超时时间（5秒），避免程序无限等待

response = requests.get(url, params=params, timeout=5)

response.raise_for_status() # 当状态码为4xx/5xx时抛出异常

return response.json()

except RequestException as e:

print("请求出错：", str(e))

return None

except json.JSONDecodeError:

print("响应数据不是有效的JSON")

return None

# 调用函数

data = get_api_data(

"http://apis.juhe.cn/simpleWeather/query",

params={"key": "你的密钥", "city": "北京"}

)

if data:

print("获取数据成功")

# 后续处理...

关键处理：

try-except捕获网络异常（如超时、连接失败）和数据解析错误。

response.raise_for_status()将 4xx/5xx 状态码转换为异常，统一错误处理逻辑。

设置timeout避免程序因网络问题长时间无响应。

总结

调用 API 获取数据的核心流程可概括为：分析接口文档→准备参数与凭证→发送请求→处理响应→存储或使用数据。在 PyCharm 中，借助requests库能快速实现这一过程，而完善的错误处理和数据解析，则能让程序更稳健、实用。

实际开发中，不同 API 的调用细节可能不同（如参数位置、认证方式），但核心逻辑一致。建议多查阅官方文档，从简单的公开 API 练起，逐步尝试更复杂的接口（如需要令牌认证的 API）。掌握 API 调用后，你可以开发出天气查询工具、数据监控程序等实用应用，让编程能力真正服务于实际需求。