使用Python调用Web API实现图表统计

Web API：Web应用编程接口，用于URL请求特定信息的程序交互，请求的数据大多以非常易于处理的格式返回，比如JSON或CSV等。

本文将使用Python中的requests包实现Web API的调用，API接口来自于GitHub提供的公用API，最后使用图表对API调用的结果进行图表统计显示。

API地址为：https://api.github.com/search/repositories?q=language:python&sort=stars，该调用返回GitHub当前托管了多少个Python项目，包括最受欢迎的Python仓库的信息，结果如下：

{

"total_count": 3114636,

"incomplete_results": false,

"items": [

{

"id": 21289110,

"node_id": "MDEwOlJlcG9zaXRvcnkyMTI4OTExMA==",

"name": "awesome-python",

"full_name": "vinta/awesome-python",

"private": false,

"owner": {

"login": "vinta",

"id": 652070,

"node_id": "MDQ6VXNlcjY1MjA3MA==",

"avatar_url": "https://avatars2.githubusercontent.com/u/652070?v=4",

...

使用Web API

如果想要Python调用Web API，需要使用requests包，该包用于处理网络请求和返回响应信息。可以使用pip工具输入以下命令进行安装：

$ pip install --user requests

使用requests处理API响应

import requests

#执行API调用并存储响应

url='https://api.github.com/search/repositories?q=language:python&sort=stars'

# 调用url，将响应对象存储在变量r中

r=requests.get(url)

# 查看请求返回的http 状态码，200表示请求成功

print("Stauts Code",r.status_code)

# 使用json()将API的响应信息(json格式)转换为一个Python字典或JSON对象

response_dict=r.json()

#处理结果

print(response_dict.keys())

执行后，输出结果如下：

Stauts Code 200

dict_keys(['total_count', 'incomplete_results', 'items'])

对返回的结果进行深度处理

针对上述API返回的结果，进一步的进行解析，返回每一个仓库的详细信息。具体见代码注释说明：

import requests

#执行API调用并存储响应

url='https://api.github.com/search/repositories?q=language:python&sort=stars'

# 调用url，将响应对象存储在变量r中

r=requests.get(url)

# 查看请求返回的http 状态码，200表示请求成功

print("Stauts Code",r.status_code)

# 使用json()将API的响应信息(json格式)转换为一个Python字典或JSON对象

response_dict=r.json()

# 获取GitHub包含的Python库数量

print("Total repositories:",response_dict["total_count"])

#探索有关仓库的信息，items是由多个字典组成的列表，每一个字典包含一个仓库信息

repo_dicts=response_dict['items']

print("Repositories returned:",len(repo_dicts))

##研究第一个仓库

#repo_dict=repo_dicts[0]

#print("\nKeys:",len(repo_dict))

#for key in sorted(repo_dict.keys()):

# print(key)

print("\nSelected information about each repository:")

# 循环遍历获取每一个仓库的详细信息

for repo_dict in repo_dicts:

# 项目名称

print('\nName:', repo_dict['name'])

# 键owner来访问表示所有者的字典，再使用键key来获取所有者的登录名。

print('Owner:', repo_dict['owner']['login'])

print('Stars:', repo_dict['stargazers_count'])

print('Repository:', repo_dict['html_url'])

print('Created:', repo_dict['created_at'])

print('Updated:', repo_dict['updated_at'])

print('Description:', repo_dict['description'])

上述代码返回的结果如下：

Stauts Code 200

Total repositories: 3114623

Repositories returned: 30

Selected information about each repository:

Name: awesome-python

Owner: vinta

Stars: 56507

Repository: https://github.com/vinta/awesome-python

Created: 2014-06-27T21:00:06Z

Updated: 2018-10-21T22:26:31Z

Description: A curated list of awesome Python frameworks, libraries, software an

d resources

Name: system-design-primer

Owner: donnemartin

Stars: 50650

Repository: https://github.com/donnemartin/system-design-primer

Created: 2017-02-26T16:15:28Z

Updated: 2018-10-21T22:02:07Z

Description: Learn how to design large-scale systems. Prep for the system design

interview. Includes Anki flashcards.

Name: models

....

注意：大多数API都存在速率限制，即你在特定时间内可执行的请求数存在限制。要获悉你是否接近了GitHub的限制，请在浏览器中输入https://api.github.com/rate_limit，你将看到类似于下面的响应：

通过结果可以指定，极限为每分钟10个请求。

使用Pygal对分析的结果进行可视化

完整代码如下所示，具体说明见代码中的详细注释：

import requests

import pygal

from pygal.style import LightColorizedStyle as LCS, LightenStyle as LS

#执行API调用并存储响应

url='https://api.github.com/search/repositories?q=language:python&sort=stars'

# 调用url，将响应对象存储在变量r中

r=requests.get(url)

# 查看请求返回的http 状态码，200表示请求成功

print("Stauts Code",r.status_code)

# 使用json()将API的响应信息(json格式)转换为一个Python字典或JSON对象

response_dict=r.json()

# 获取GitHub包含的Python库数量

print("Total repositories:",response_dict["total_count"])

#探索有关仓库的信息，items是由多个字典组成的列表，每一个字典包含一个仓库信息

repo_dicts=response_dict['items']

#print("Repositories returned:",len(repo_dicts))

## 创建两个空列表存储包含在图表中的信息，名称用于条形图表的标签，星的数量用于确定条形图表的高度

#names,stars=[],[]

# plot_dicts用于添加自定义工具提示

names,plot_dicts=[],[]

for repo_dict in repo_dicts:

names.append(repo_dict["name"])

# 并不是每个节点一定有description，所以加if判断

if repo_dict["description"]:

plot_dict={

# Pygal根据与键'value'相关联的数字来确定条形的高度

'value':int(repo_dict["stargazers_count"]),

# 使用与'label'相关联的字符串给条形创建工具提示

'label':repo_dict["description"],

# 为条形图表添加可点击的链接

'xlink': repo_dict['html_url'],

}

plot_dicts.append(plot_dict)

#可视化，定义样式，将其基色设置为深蓝色，并传入LightColorizedStyle

my_style=LS('#333366',base_style=LCS)

my_config = pygal.Config()

# 表示让标签绕x轴旋转45度

my_config.x_label_rotation = 45

# 表示隐藏了图例

my_config.show_legend = False

# 图表标题字体大小

my_config.title_font_size = 24

# 副标签字体大小，包括x轴上的项目名以及y轴上的大部分数字

my_config.label_font_size = 14

# 主标签字体大小，y轴上为5000整数倍的刻度

my_config.major_label_font_size = 18

# 将较长的项目名缩短为15个字符

my_config.truncate_label = 15

# 隐藏图表中的水平线

my_config.show_y_guides = False

# 设置了自定义宽度

my_config.width = 1000

# 使用Bar()创建一个简单的条形图

# x_label_rotation=45：表示让标签绕x轴旋转45度

# show_legend=False：表示隐藏了图例

# chart=pygal.Bar(style=my_style,x_label_rotation=45,show_legend=False)

# 将上述的配置进行改进，分装为一个my_config对象

# 传递配置设置

chart=pygal.Bar(my_config,style=my_style)

chart.title="Most-Starred Python Projects on GitHub"

chart.x_labels=names

# 暂不需要添加标签

#chart.add('',stars)

# 添加工具提示需要的字典列表

chart.add('',plot_dicts)

chart.render_to_file("python_repos.svg")

#print("\nSelected information about each repository:")

## 循环遍历获取每一个仓库的详细信息

#for repo_dict in repo_dicts:

# # 项目名称

# print('\nName:', repo_dict['name'])

# # 键owner来访问表示所有者的字典，再使用键key来获取所有者的登录名。

# print('Owner:', repo_dict['owner']['login'])

# print('Stars:', repo_dict['stargazers_count'])

# print('Repository:', repo_dict['html_url'])

# print('Created:', repo_dict['created_at'])

# print('Updated:', repo_dict['updated_at'])

# print('Description:', repo_dict['description'])

上述代码中，使用了pygal.Bar()方法创建一个简单的条形图，并向它传递了my_style。同时还传递了另外两个样式实参：让标签绕x轴旋转45度(x_label_rotation=45)，并隐藏了图例(show_legend=False)，因为只在图表中绘制一个数据系列。

执行代码显示结果如下图所示：

参考资源

《Python编程：从入门到实践》

本文后续会随着知识的积累不断补充和更新，内容如有错误，欢迎指正。

最后一次更新时间：2018-10-23