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

2025-08-03 21:50
文章标签 python 接口 使用 步骤 详细 调用 api requests

本文主要是介绍使用Python的requests库调用API接口的详细步骤，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

《使用Python的requests库调用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请php求
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 = respChina编程onse.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.sjavascripttatus_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 = {
    "fandroidile": 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接口的资料请关注China编程(www.chinasem.cn)其它相关文章！

这篇关于使用Python的requests库调用API接口的详细步骤的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1155585。

相关文章

Java中流式并行操作parallelStream的原理和使用方法

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流（parallelStream）的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS
阅读更多...
Linux join命令的使用及说明

Linux join命令的使用及说明

《Linuxjoin命令的使用及说明》`join`命令用于在Linux中按字段将两个文件进行连接,类似于SQL的JOIN,它需要两个文件按用于匹配的字段排序,并且第一个文件的换行符必须是LF,`jo... 目录一. 基本语法二. 数据准备三. 指定文件的连接key四.-a输出指定文件的所有行五.-o指定输出
阅读更多...
Linux jq命令的使用解读

Linux jq命令的使用解读

《Linuxjq命令的使用解读》jq是一个强大的命令行工具,用于处理JSON数据,它可以用来查看、过滤、修改、格式化JSON数据,通过使用各种选项和过滤器,可以实现复杂的JSON处理任务... 目录一. 简介二. 选项2.1.2.2-c2.3-r2.4-R三. 字段提取3.1 普通字段3.2 数组字段四.
阅读更多...
Linux kill正在执行的后台任务 kill进程组使用详解

Linux kill正在执行的后台任务 kill进程组使用详解

《Linuxkill正在执行的后台任务kill进程组使用详解》文章介绍了两个脚本的功能和区别,以及执行这些脚本时遇到的进程管理问题,通过查看进程树、使用`kill`命令和`lsof`命令,分析了子... 目录零. 用到的命令一. 待执行的脚本二. 执行含子进程的脚本，并kill2.1 进程查看2.2 遇到的
阅读更多...
详解SpringBoot+Ehcache使用示例

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储：配置灵活性：编码示例引入依赖：配置ehcache.XML文件：配置
阅读更多...
Java 虚拟线程的创建与使用深度解析

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程？1.2 为什么需要虚拟线程？二、虚拟线程与平台线程对比代码对比示例：三
阅读更多...
k8s按需创建PV和使用PVC详解

k8s按需创建PV和使用PVC详解

《k8s按需创建PV和使用PVC详解》Kubernetes中,PV和PVC用于管理持久存储,StorageClass实现动态PV分配,PVC声明存储需求并绑定PV,通过kubectl验证状态,注意回收... 目录1.按需创建 PV（使用 StorageClass）创建 StorageClass2.创建 PV
阅读更多...
vite搭建vue3项目的搭建步骤

vite搭建vue3项目的搭建步骤

《vite搭建vue3项目的搭建步骤》本文主要介绍了vite搭建vue3项目的搭建步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学... 目录1.确保Nodejs环境2.使用vite-cli工具3.进入项目安装依赖1.确保Nodejs环境
阅读更多...
Python版本信息获取方法详解与实战

Python版本信息获取方法详解与实战

《Python版本信息获取方法详解与实战》在Python开发中,获取Python版本号是调试、兼容性检查和版本控制的重要基础操作,本文详细介绍了如何使用sys和platform模块获取Python的主... 目录1. python版本号获取基础2. 使用sys模块获取版本信息2.1 sys模块概述2.1.1
阅读更多...
Nginx搭建前端本地预览环境的完整步骤教学

Nginx搭建前端本地预览环境的完整步骤教学

《Nginx搭建前端本地预览环境的完整步骤教学》这篇文章主要为大家详细介绍了Nginx搭建前端本地预览环境的完整步骤教学,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下... 目录项目目录结构核心配置文件：nginx.conf脚本化操作：nginx.shnpm 脚本集成总结：对前端的意义很多
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2