使用Python的requests库调用API接口的详细步骤

 更新时间:2025年08月03日 13:38:09   作者:兵临天下api  
使用 Python 的requests库调用 API 接口是开发中最常用的方式之一,它简化了 HTTP 请求的处理流程,以下是详细步骤和实战示例,涵盖各种常见场景,需要的朋友可以参考下

使用 Python 的requests库调用 API 接口是开发中最常用的方式之一,它简化了 HTTP 请求的处理流程。以下是详细步骤和实战示例,涵盖各种常见场景:

一、准备工作:安装 requests 库

如果尚未安装,先通过 pip 安装:

pip install requests

二、基本调用流程(以 RESTful API 为例)

1. 导入 requests 库

import requests

2. 发送请求并获取响应

以调用一个获取商品信息的 GET 接口为例:

# API地址URL
url = "https://api.example.com/products/123"

# 发送GET请求
response = requests.get(url)

# 查看响应状态码(200表示成功)
print("状态码:", response.status_code)

# 查看响应内容(默认是字符串格式)
print("响应内容:", response.text)

# 解析JSON格式的响应(最常用)
if response.status_code == 200:
    data = response.json()  # 自动解析JSON,返回字典/列表
    print("商品名称:", data["name"])
    print("商品价格:", data["price"])

三、不同请求类型的调用方式

1. GET 请求(查询数据)

常用于获取数据,参数通过 URL 的查询字符串传递:

url = "https://api.example.com/products"

# 请求参数(会自动拼接到URL后面:?category=electronics&page=1)
params = {
    "category": "electronics",  # 商品分类
    "page": 1                   # 页码
}

# 发送带参数的GET请求
response = requests.get(url, params=params)

# 查看最终请求的URL
print("请求URL:", response.url)  # 输出:https://api.example.com/products?category=electronics&page=1

# 解析响应
if response.ok:  # response.ok 等价于 status_code == 200
    products = response.json()["data"]
    for product in products:
        print(product["id"], product["name"])

2. POST 请求(提交数据)

常用于创建资源(如提交表单、创建订单),数据放在请求体中:

url = "https://api.example.com/orders"

# 请求头(告诉服务器数据格式为JSON)
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer your_token_here"  # 认证令牌(如有)
}

# 请求体数据(JSON格式)
payload = {
    "product_id": 123,
    "quantity": 2,
    "address": "北京市朝阳区..."
}

# 发送POST请求(json参数会自动序列化并设置Content-Type为application/json)
response = requests.post(url, json=payload, headers=headers)

# 处理响应
if response.status_code == 201:  # 201表示资源创建成功
    order = response.json()
    print("创建订单成功,订单号:", order["order_id"])
else:
    print("创建失败:", response.text)

3. PUT/PATCH 请求(更新数据)

  • PUT:全量更新资源(需提供完整数据)
  • PATCH:部分更新资源(仅提供需修改的字段)
# 更新商品价格(PATCH示例)
url = "https://api.example.com/products/123"
headers = {"Authorization": "Bearer your_token_here"}
payload = {"price": 3999}  # 仅更新价格字段

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

if response.ok:
    print("更新成功")

4. DELETE 请求(删除数据)

url = "https://api.example.com/products/123"
headers = {"Authorization": "Bearer your_token_here"}

response = requests.delete(url, headers=headers)

if response.status_code == 204:  # 204表示删除成功(无返回内容)
    print("删除成功")

四、处理认证与权限

多数 API 需要身份验证,常见方式:

1. API Key 认证

url = "https://api.example.com/data"
params = {
    "api_key": "your_api_key_here"  # 在查询参数中携带API Key
}
response = requests.get(url, params=params)

2. Token 认证(Bearer Token)

url = "https://api.example.com/data"
headers = {
    "Authorization": "Bearer your_token_here"  # 在请求头中携带Token
}
response = requests.get(url, headers=headers)

3. 基础认证(Basic Auth)

url = "https://api.example.com/data"
# 传入用户名和密码,requests会自动处理编码
response = requests.get(url, auth=("username", "password"))

五、处理异常与错误

网络请求可能遇到各种问题,需添加异常处理:

url = "https://api.example.com/products"

try:
    # 设置超时时间(防止无限等待)
    response = requests.get(url, timeout=10)  # 10秒超时

    # 主动抛出HTTP错误(如404、500)
    response.raise_for_status()

except requests.exceptions.HTTPError as e:
    print(f"HTTP错误:{e}")  # 如401权限不足、404未找到
except requests.exceptions.ConnectionError:
    print("连接错误(可能是URL错误或网络问题)")
except requests.exceptions.Timeout:
    print("请求超时")
except requests.exceptions.RequestException as e:
    print(f"其他错误:{e}")
else:
    # 无异常时处理响应
    print("请求成功,数据:", response.json())

六、高级用法

1. 会话保持(复用连接)

多次调用同一 API 时,用Session保持连接,提升效率:

# 创建会话对象
with requests.Session() as session:
    # 会话中设置全局headers(所有请求都会携带)
    session.headers.update({"Authorization": "Bearer your_token"})
    
    # 第一次请求(建立连接)
    response1 = session.get("https://api.example.com/products/1")
    # 第二次请求(复用连接,速度更快)
    response2 = session.get("https://api.example.com/products/2")

2. 上传文件

url = "https://api.example.com/upload"
files = {
    "file": open("image.jpg", "rb")  # 打开文件(二进制模式)
}

response = requests.post(url, files=files)
print("上传结果:", response.json())

七、总结

requests库调用 API 的核心流程是:

  1. 确定请求类型(GET/POST 等)和 URL;
  2. 准备参数(params)、请求体(json/payload)、请求头(headers);
  3. 发送请求并处理响应(解析 JSON、判断状态码);
  4. 添加异常处理确保代码健壮性。

通过上述方法,可应对绝大多数 API 调用场景,包括电商平台接口、支付接口、第三方服务接口等。实际开发中需结合具体 API 文档调整参数和格式。

以上就是使用Python的requests库调用API接口的详细步骤的详细内容,更多关于Python requests调用API接口的资料请关注脚本之家其它相关文章!

相关文章

  • 详解python中的异常和文件读写

    详解python中的异常和文件读写

    这篇文章主要介绍了python中的异常和文件读写的的相关资料,帮助大家更好的理解和使用python,感兴趣的朋友可以了解下
    2021-01-01
  • Python中的np.random.seed()随机数种子问题及解决方法

    Python中的np.random.seed()随机数种子问题及解决方法

    随机数种子,相当于我给接下来需要生成的随机数一个初值,按照我给的这个初值,按固定顺序生成随机数,接下来通过本文给大家介绍Python中的np.random.seed()随机数种子问题,需要的朋友可以参考下
    2022-04-04
  • django的403/404/500错误自定义页面的配置方式

    django的403/404/500错误自定义页面的配置方式

    这篇文章主要介绍了django的403/404/500错误自定义页面的配置方式,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-05-05
  • python爬虫入门教程--利用requests构建知乎API(三)

    python爬虫入门教程--利用requests构建知乎API(三)

    这篇文章主要给大家介绍了关于python爬虫入门之利用requests构建知乎API的相关资料,文中通过示例代码介绍的非常详细,对大家具有一定的参考学习价值,需要的朋友们下面来一起看看吧。
    2017-05-05
  • Python中的"没有那个文件"错误(FileNotFoundError)的解决方法详解

    Python中的"没有那个文件"错误(FileNotFoundError)的解决方法详解

    在Python编程中,遇到“没有那个文件”错误(FileNotFoundError)是常见的问题之一,本文将详细分析这个错误的原因,并提供实用的解决方案和指南,有需要的可以参考下
    2024-11-11
  • python中创建一个包并引用使用的操作方法

    python中创建一个包并引用使用的操作方法

    python包在开发中十分常见,一般通过导入包含特定功能的python模块包进行使用。当然,也可以自己创建打包模块,然后发布,安装使用,这篇文章主要介绍了python中如何创建一个包并引用使用,需要的朋友可以参考下
    2022-08-08
  • python3 hdf5文件 遍历代码

    python3 hdf5文件 遍历代码

    这篇文章主要介绍了python3 hdf5文件 遍历代码,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-05-05
  • Python元组的定义及使用

    Python元组的定义及使用

    这篇文章主要介绍了Python元组的定义及使用,在Python中元组是一个和列表非常类似的数据类型,不同之处就是列表中的元素可以修改,而元组之中的元素不可以修改。想具体了解的下小伙伴请参考下面文章的具体内容,希望对你有所帮助
    2021-11-11
  • pandas如何将dataframe中的NaN替换成None

    pandas如何将dataframe中的NaN替换成None

    这篇文章主要介绍了pandas如何将dataframe中的NaN替换成None问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-08-08
  • Python numpy矩阵处理运算工具用法汇总

    Python numpy矩阵处理运算工具用法汇总

    这篇文章主要介绍了Python numpy矩阵处理运算工具用法汇总,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-07-07

最新评论