首页 > 文章 > python教程

如何使用Python调用第三方API_接口对接完整示例【指导】

时间：2025-12-21 16:34:12 158浏览收藏

推广推荐

免费电影APP ➜

支持 PC / 移动端，安全直达

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习文章相关编程知识。下面本篇文章就来带大家聊聊《如何使用Python调用第三方API_接口对接完整示例【指导】》，介绍一下，希望对大家的知识积累有所帮助，助力实战开发！

Python调用第三方API核心是构造请求、发送请求、解析响应三步，关键在认证、错误处理和数据格式；需先读文档明确URL、方法、认证方式、参数位置及响应结构。

如何使用Python调用第三方API_接口对接完整示例【指导】

用 Python 调用第三方 API，核心就三步：构造请求、发送请求、解析响应。关键在处理认证、错误、数据格式这些细节，下面用真实场景讲清楚。

准备：安装依赖并确认 API 文档

绝大多数 REST API 都用 requests 库调用，先装好：

pip install requests

接着务必打开目标 API 的官方文档（比如 GitHub API、高德地图、聚合数据等），重点关注：

请求地址（URL）和请求方法（GET/POST）
是否需要认证（API Key、Token、Authorization 头）
参数传递方式（query string、JSON body、form data）
成功和失败时的响应结构（尤其是 status code 和 error 字段）

基础 GET 请求：带参数和认证

以「获取当前天气」为例（使用免费的 OpenWeather API）：

# 替换为你自己的 API Key
API_KEY = "your_api_key_here"
CITY = "shanghai"
url = f"https://api.openweathermap.org/data/2.5/weather?q={CITY}&appid={API_KEY}&units=metric"

import requests
response = requests.get(url)

if response.status_code == 200:
  data = response.json()
  temp = data["main"]["temp"]
  print(f"上海当前温度：{temp}°C")
else:
  print("请求失败，状态码：", response.status_code)
  print("错误信息：", response.text)

注意点：

参数直接拼在 URL 后（query string），适合 GET
API Key 通常放 query 或 headers，看文档要求；OpenWeather 放 query 更简单
一定要检查 status_code，不能只靠 try-except

POST 请求：传 JSON 数据（如登录或提交表单）

假设某接口需 POST JSON 提交用户登录信息：

url = "https://api.example.com/v1/login"
payload = {
  "username": "testuser",
  "password": "123456"
}
headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer abc123xyz"
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
  token = response.json().get("access_token")
  print("登录成功，拿到 token：", token)
elif response.status_code == 401:
  print("用户名或密码错误")
else:
  print("其他错误：", response.json())

重点说明：

用 json= 参数自动序列化并加 Content-Type 头，比手动 dumps + headers 更安全
敏感操作（如登录）通常需要 Authorization header，格式按文档来（Bearer / Basic / APIKey）
区分 4xx（客户端错）和 5xx（服务端错），针对性处理

封装成函数：提升复用性和健壮性

实际项目中别写一堆裸 requests，封装一个通用 client：

import requests
import time

class APIClient:
  def __init__(self, base_url, api_key=None):
    self.base_url = base_url.rstrip("/")
    self.session = requests.Session()
    if api_key:
      self.session.headers.update({"X-API-Key": api_key})

  def get(self, endpoint, params=None, timeout=10):
    url = f"{self.base_url}/{endpoint.lstrip('/')}"
    try:
      resp = self.session.get(url, params=params, timeout=timeout)
      resp.raise_for_status()  # 自动抛出 4xx/5xx 异常
      return resp.json()
    except requests.exceptions.RequestException as e:
      print(f"请求异常：{e}")
      return None

# 使用示例
client = APIClient("https://api.example.com", api_key="xxx")
data = client.get("/users", params={"limit": 10})

这样做的好处：

统一管理 base_url、headers、超时、重试逻辑（可后续加）
自动处理常见异常，避免每次重复写 if status_code
方便后期加日志、鉴权刷新、请求限频等扩展

基本上就这些。不复杂但容易忽略的是：读文档、验状态码、分情况处理错误、别把密钥硬编码。跑通一次后，换别的 API 只是改 URL 和参数，套路完全一样。

理论要掌握，实操不能落！以上关于《如何使用Python调用第三方API_接口对接完整示例【指导】》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！