Python API教程:API入门
什么是API?
一个API,或被称为应用程序接口,是一个服务器为你提供一个接收或发送数据的代码。API通常用来接收数据。
本文就集中焦点在此话题中。
当我们想从一个API中接收数据,我们需要开始请求。请求可以包含整个Web。例如,你可以浏览博客文章。你的浏览器开始请求我们的Web服务器,会返回整个网页内容。
API请求工作都遵循类似的路径,你发布一个请求到一个API服务器,它返回给你请求的数据。
如何在Python中发起API请求
在Python中,通常使用通用扩展库来发起API请求,这个库称为:Request库(https://2.python-requests.org/en/master/)。该请求库一分属于Python标准库,但需要我们来安装后才能使用。
一般人们都使用pip来管理Python的包,可以使用如下命令来安装它:
pip install requests
如果你使用conda,可以使用如下命令:
conda install requests
当我们安装好了这个库,在代码中就可以导入它。这是代码中的第一步:
import requests
现在我们已经导入了requests库,现在开始编码。
创建第一个API请求
这是我们第一个API请求,使用GET请求数据,这种方法也是常见的操作。
当我们发起请求,API通常会返回我们返回的编码,告诉是否请求成功。返回代码会立即告诉开发者是否有错误发生。
要创建GET请求,我们通常使用request.get()方法,需要一些URL参数。我们开始给API发起请求,类似于如下格式:
response = requests.get("http://api.open-notify.org/this-api-response-exist/")
get()函数返回一个response对象,可以用response.status_code属性来接收请求的状态码:
print(reponse.status_code)
它会返回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)
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}
在Python中使用JSON数据
JSON是API的标准语言。它是一种编码数据结构,可以确保被机器有效读取。
JSON很像Python的列表、字典、字符串和整数,我们可以将JSON视为字符串表示这些对象的组合。
Python对JSON文件提供了json的软件,用来解析转换JSON。json软件包是标准库的一部分,无需额外安装即可使用,即可以将列表和字典转换为JSON,也可以将字符转换为列表和字典。
json库有以下两个功能:
json.dumps()
用来接收一个Python对象,并将其转换为字符串;
json.loads()
接收JSON字符串,并将其转换为Python对象。
免责声明:
① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。
② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341