Python API教程:API入门

简介: 一个API,或被称为应用程序接口,是一个服务器为你提供一个接收或发送数据的代码。API通常用来接收数据。本文就集中焦点在此话题中。当我们想从一个API中接收数据,我们需要开始请求。请求可以包含整个Web。例如,你可以浏览博客文章。你的浏览器开始请求我们的Web服务器,会返回整个网页内容。

什么是API?


一个API,或被称为应用程序接口,是一个服务器为你提供一个接收或发送数据的代码。API通常用来接收数据。


本文就集中焦点在此话题中。


当我们想从一个API中接收数据,我们需要开始请求。请求可以包含整个Web。例如,你可以浏览博客文章。你的浏览器开始请求我们的Web服务器,会返回整个网页内容。

7b349ec277308c7a920f0fcf70e3646.png




API请求工作都遵循类似的路径,你发布一个请求到一个API服务器,它返回给你请求的数据。


如何在Python中发起API请求


在Python中,通常使用通用扩展库来发起API请求,这个库称为:Request库(https://2.python-requests.org/en/master/)。该请求库一分属于Python标准库,但需要我们来安装后才能使用。


一般人们都使用pip来管理Python的包,可以使用如下命令来安装它:


pip install requests

1

如果你使用conda,可以使用如下命令:


conda install requests

1

当我们安装好了这个库,在代码中就可以导入它。这是代码中的第一步:


import requests

1

现在我们已经导入了requests库,现在开始编码。


创建第一个API请求


这是我们第一个API请求,使用GET请求数据,这种方法也是常见的操作。


当我们发起请求,API通常会返回我们返回的编码,告诉是否请求成功。返回代码会立即告诉开发者是否有错误发生。


要创建GET请求,我们通常使用request.get()方法,需要一些URL参数。我们开始给API发起请求,类似于如下格式:


response = requests.get("http://api.open-notify.org/this-api-response-exist/")

1

get()函数返回一个response对象,可以用response.status_code属性来接收请求的状态码:


print(reponse.status_code)

1

它会返回404的状态码。程序员们都会知道,这是服务器端告诉我们,请求的文件不存在。


来看常见的API状态码


每次请求服务器都会返回状态码。以下是GET请求时相关的一些代码:


200:一切正常,结果已返回(如果有)。


301:服务器将重定向到其它节点。当切换域名或更改节点名称时,会发生这种情况。


400:服务器认为你发出了错误的请求。当没有正确发送数据时,会发生这种情况。


401:服务器认为您未通过身份验证。许多API都需要登录证书,因此当您没有发送正确的证书来访问API时,就会发生这种情况。


403:您尝试访问的资源被禁止:您没有正确的权限才能查看它。


404:在服务器上找不到要访问的资源。


503:服务器尚未准备好处理请求。


可以看到以4和5开头的都代表某种错误。以2开头的状态码表示成功。


API文档


为了确保人们能够正确发出请求,在使用API时,请务必参考API文档。编写文档会让人们有所畏惧,但使用的越来越多,你会发现它变得越来越容易。


我们将使用Open Notify API(Open Notify - Page Not Found


通常,指定服务器上会提供多个API,这些API每一个都称为节点。我们将使用的第一个节点是:


http://api.open-notify.org/astros.json


它返回有关当前太空中宇航员的数据。


我们使用如下代码,向该API发起GET请求:


response = requests.get("http://api.open-notify.org/astros.json")print(response.status_code)

1

200


它将返回200代码,告诉我们请求成功了。API文档上告诉我们,它会返回Json数据。我们使用response.json()来接收从API返回的数据。


print(response.json())
{'message': 'success', 'people': [{'name': 'Alexey Ovchinin', 'craft': 'ISS'}, {'name': 'Nick Hague', 'craft': 'ISS'}, {'name': 'Christina Koch', 'craft': 'ISS'}, {'name': 'Alexander Skvortsov', 'craft': 'ISS'}, {'name': 'Luca Parmitano', 'craft': 'ISS'}, {'name': 'Andrew Morgan', 'craft': 'ISS'}], 'number': 6}

1

2

3

在Python中使用JSON数据


JSON是API的标准语言。它是一种编码数据结构,可以确保被机器有效读取。


JSON很像Python的列表、字典、字符串和整数,我们可以将JSON视为字符串表示这些对象的组合。


328d9c18045e4b467d4664db1f9c54d.png



Python对JSON文件提供了json的软件,用来解析转换JSON。json软件包是标准库的一部分,无需额外安装即可使用,即可以将列表和字典转换为JSON,也可以将字符转换为列表和字典。


json库有以下两个功能:


json.dumps()


用来接收一个Python对象,并将其转换为字符串;


json.loads()


接收JSON字符串,并将其转换为Python对象。


相关文章
|
10月前
|
SQL 关系型数据库 数据库
Python SQLAlchemy模块:从入门到实战的数据库操作指南
免费提供Python+PyCharm编程环境,结合SQLAlchemy ORM框架详解数据库开发。涵盖连接配置、模型定义、CRUD操作、事务控制及Alembic迁移工具,以电商订单系统为例,深入讲解高并发场景下的性能优化与最佳实践,助你高效构建数据驱动应用。
1104 7
|
11月前
|
测试技术 开发者 Python
Python单元测试入门:3个核心断言方法,帮你快速定位代码bug
本文介绍Python单元测试基础,详解`unittest`框架中的三大核心断言方法:`assertEqual`验证值相等,`assertTrue`和`assertFalse`判断条件真假。通过实例演示其用法,帮助开发者自动化检测代码逻辑,提升测试效率与可靠性。
658 1
|
11月前
|
人工智能 数据可视化 测试技术
Postman 性能测试教程:快速上手 API 压测
本文介绍API上线后因高频调用导致服务器告警,通过Postman与Apifox进行压力测试排查性能瓶颈。对比两款工具在批量请求、断言验证、可视化报告等方面的优劣,探讨API性能优化策略及行业未来发展方向。
Postman 性能测试教程:快速上手 API 压测
|
10月前
|
JSON 算法 API
Python采集淘宝商品评论API接口及JSON数据返回全程指南
Python采集淘宝商品评论API接口及JSON数据返回全程指南
|
10月前
|
JSON API 数据安全/隐私保护
Python采集淘宝拍立淘按图搜索API接口及JSON数据返回全流程指南
通过以上流程,可实现淘宝拍立淘按图搜索的完整调用链路,并获取结构化的JSON商品数据,支撑电商比价、智能推荐等业务场景。
|
10月前
|
Cloud Native 算法 API
Python API接口实战指南:从入门到精通
🌟蒋星熠Jaxonic,技术宇宙的星际旅人。深耕API开发,以Python为舟,探索RESTful、GraphQL等接口奥秘。擅长requests、aiohttp实战,专注性能优化与架构设计,用代码连接万物,谱写极客诗篇。
1977 1
Python API接口实战指南:从入门到精通
|
11月前
|
数据采集 存储 XML
Python爬虫技术:从基础到实战的完整教程
最后强调: 父母法律法规限制下进行网络抓取活动; 不得侵犯他人版权隐私利益; 同时也要注意个人安全防止泄露敏感信息.
1151 19
|
10月前
|
索引 Python
Python 列表切片赋值教程:掌握 “移花接木” 式列表修改技巧
本文通过生动的“嫁接”比喻,讲解Python列表切片赋值操作。切片可修改原列表内容,实现头部、尾部或中间元素替换,支持不等长赋值,灵活实现列表结构更新。
518 1
|
10月前
|
存储 Java 调度
Python定时任务实战:APScheduler从入门到精通
APScheduler是Python强大的定时任务框架,通过触发器、执行器、任务存储和调度器四大组件,灵活实现各类周期性任务。支持内存、数据库、Redis等持久化存储,适用于Web集成、数据抓取、邮件发送等场景,解决传统sleep循环的诸多缺陷,助力构建稳定可靠的自动化系统。(238字)
1697 1
|
人工智能 Java Python
python入门(二)安装第三方包
python入门(二)安装第三方包
287 1

推荐镜像

更多