python如何制作api

使用 Python 和 Flask 设计 RESTful API

近些年来 REST (REpresentational State Transfer) 已经变成了 web services 和 web APIs 的标配。

在本文中我将向你展示如何简单地使用 Python 和 Flask 框架来创建一个 RESTful 的 web service。

什么是 REST?

六条设计规范定义了一个 REST 系统的特点:

  • 客户端-服务器: 客户端和服务器之间隔离,服务器提供服务,客户端进行消费。

  • 无状态: 从客户端到服务器的每个请求都必须包含理解请求所必需的信息。换句话说, 服务器不会存储客户端上一次请求的信息用来给下一次使用。

  • 可缓存: 服务器必须明示客户端请求能否缓存。

  • 分层系统: 客户端和服务器之间的通信应该以一种标准的方式,就是中间层代替服务器做出响应的时候,客户端不需要做任何变动。

  • 统一的接口: 服务器和客户端的通信方法必须是统一的。

  • 按需编码: 服务器可以提供可执行代码或脚本,为客户端在它们的环境中执行。这个约束是唯一一个是可选的。

  • 什么是一个 RESTful 的 web service?

    REST 架构的最初目的是适应万维网的 HTTP 协议。

    RESTful web services 概念的核心就是“资源”。 资源可以用 URI 来表示。客户端使用 HTTP 协议定义的方法来发送请求到这些 URIs,当然可能会导致这些被访问的”资源“状态的改变。

    HTTP 标准的方法有如下:

  • ==========  =====================  ==================================

  • HTTP 方法   行为                   示例

  • ==========  =====================  ==================================

  • GET         获取资源的信息         http://example.com/api/orders

  • GET         获取某个特定资源的信息 http://example.com/api/orders/123

  • POST        创建新资源             http://example.com/api/orders

  • PUT         更新资源               http://example.com/api/orders/123

  • DELETE      删除资源               http://example.com/api/orders/123

  • ==========  ====================== ==================================

  • REST 设计不需要特定的数据格式。在请求中数据可以以 JSON 形式, 或者有时候作为 url 中查询参数项。

    设计一个简单的 web service

    坚持 REST 的准则设计一个 web service 或者 API 的任务就变成一个标识资源被展示出来以及它们是怎样受不同的请求方法影响的练习。

    比如说,我们要编写一个待办事项应用程序而且我们想要为它设计一个 web service。要做的第一件事情就是决定用什么样的根 URL 来访问该服务。例如,我们可以通过这个来访问:

    http://[hostname]/todo/api/v1.0/

    在这里我已经决定在 URL 中包含应用的名称以及 API 的版本号。在 URL 中包含应用名称有助于提供一个命名空间以便区分同一系统上的其它服务。在 URL 中包含版本号能够帮助以后的更新,如果新版本中存在新的和潜在不兼容的功能,可以不影响依赖于较旧的功能的应用程序。

    下一步骤就是选择将由该服务暴露(展示)的资源。这是一个十分简单地应用,我们只有任务,因此在我们待办事项中唯一的资源就是任务。

    我们的任务资源将要使用 HTTP 方法如下:

  • ==========  ===============================================  =============================

  • HTTP 方法   URL                                              动作

  • ==========  ===============================================  ==============================

  • GET         http://[hostname]/todo/api/v1.0/tasks            检索任务列表

  • GET         http://[hostname]/todo/api/v1.0/tasks/[task_id]  检索某个任务

  • POST        http://[hostname]/todo/api/v1.0/tasks            创建新任务

  • PUT         http://[hostname]/todo/api/v1.0/tasks/[task_id]  更新任务

  • DELETE      http://[hostname]/todo/api/v1.0/tasks/[task_id]  删除任务

  • ==========  ================================================ =============================

  • 我们定义的任务有如下一些属性:

  • id: 任务的唯一标识符。数字类型。

  • title: 简短的任务描述。字符串类型。

  • description: 具体的任务描述。文本类型。

  • done: 任务完成的状态。布尔值。

  • 目前为止关于我们的 web service 的设计基本完成。剩下的事情就是实现它!

    Flask 框架的简介

    如果你读过 Flask Mega-Tutorial 系列,就会知道 Flask 是一个简单却十分强大的 Python web 框架。

    在我们深入研究 web services 的细节之前,让我们回顾一下一个普通的 Flask Web 应用程序的结构。

    我会首先假设你知道 Python 在你的平台上工作的基本知识。 我将讲解的例子是工作在一个类 Unix 操作系统。简而言之,这意味着它们能工作在 Linux,Mac OS X 和 Windows(如果你使用Cygwin)。 如果你使用 Windows 上原生的 Python 版本的话,命令会有所不同。

    让我们开始在一个虚拟环境上安装 Flask。如果你的系统上没有 virtualenv,你可以从https://pypi.python.org/pypi/virtualenv 上下载:

  • $ mkdir todo-api

  • $ cd todo-api

  • $ virtualenv flask

  • New python executable in flask/bin/python

  • Installing setuptools............................done.

  • Installing pip...................done.

  • $ flask/bin/pip install flask

  • 既然已经安装了 Flask,现在开始创建一个简单地网页应用,我们把它放在一个叫 app.py 的文件中:

  • #!flask/bin/pythonfrom flask import Flaskapp = Flask(__name__)@app.route(/)def index():

  •    return "Hello, World!"if __name__ == __main__:

  •    app.run(debug=True)

  • 为了运行这个程序我们必须执行 app.py:

  • $ chmod a+x app.py

  • $ ./app.py

  • * Running on http://127.0.0.1:5000/

  • * Restarting with reloader

  • 现在你可以启动你的网页浏览器,输入 http://localhost:5000 看看这个小应用程序的效果。

    简单吧?现在我们将这个应用程序转换成我们的 RESTful service!

    使用 Python 和 Flask 实现 RESTful services

    使用 Flask 构建 web services 是十分简单地,比我在 Mega-Tutorial 中构建的完整的服务端的应用程序要简单地多。

    在 Flask 中有许多扩展来帮助我们构建 RESTful services,但是在我看来这个任务十分简单,没有必要使用 Flask 扩展。

    我们 web service 的客户端需要添加、删除以及修改任务的服务,因此显然我们需要一种方式来存储任务。最直接的方式就是建立一个小型的数据库,但是数据库并不是本文的主体。学习在 Flask 中使用合适的数据库,我强烈建议阅读 Mega-Tutorial。

    这里我们直接把任务列表存储在内存中,因此这些任务列表只会在 web 服务器运行中工作,在结束的时候就失效。 这种方式只是适用我们自己开发的 web 服务器,不适用于生产环境的 web 服务器, 这种情况一个合适的数据库的搭建是必须的。

    我们现在来实现 web service 的第一个入口:

  • #!flask/bin/pythonfrom flask import Flask, jsonifyapp = Flask(__name__)tasks = [

  •    {

  •        id: 1,

  •        title: uBuy groceries,

  •        description: uMilk, Cheese, Pizza, Fruit, Tylenol,

  •        done: False

  •    },

  •    {

  •        id: 2,

  •        title: uLearn Python,

  •        description: uNeed to find a good Python tutorial on the web,

  •        done: False

  •    }]@app.route(/todo/api/v1.0/tasks, methods=[GET])def get_tasks():

  •    return jsonify({tasks: tasks})if __name__ == __main__:

  •    app.run(debug=True)

  • 正如你所见,没有多大的变化。我们创建一个任务的内存数据库,这里无非就是一个字典和数组。数组中的每一个元素都具有上述定义的任务的属性。

    取代了首页,我们现在拥有一个 get_tasks 的函数,访问的 URI 为 /todo/api/v1.0/tasks,并且只允许 GET 的 HTTP 方法。

    这个函数的响应不是文本,我们使用 JSON 数据格式来响应,Flask 的 jsonify 函数从我们的数据结构中生成。

    使用网页浏览器来测试我们的 web service 不是一个最好的注意,因为网页浏览器上不能轻易地模拟所有的 HTTP 请求的方法。相反,我们会使用 curl。如果你还没有安装 curl 的话,请立即安装它。

    通过执行 app.py,启动 web service。接着打开一个新的控制台窗口,运行以下命令:

  • $ curl -i http://localhost:5000/todo/api/v1.0/tasks

  • HTTP/1.0 200 OK

  • Content-Type: application/json

  • Content-Length: 294

  • Server: Werkzeug/0.8.3 Python/2.7.3

  • Date: Mon, 20 May 2013 04:53:53 GMT


  • {

  •  "tasks": [

  •    {

  •      "description": "Milk, Cheese, Pizza, Fruit, Tylenol",

  •      "done": false,

  •      "id": 1,

  •      "title": "Buy groceries"

  •    },

  •    {

  •      "description": "Need to find a good Python tutorial on the web",

  •      "done": false,

  •      "id": 2,

  •      "title": "Learn Python"

  •    }

  •  ]

  • }

  • 我们已经成功地调用我们的 RESTful service 的一个函数!

    现在我们开始编写 GET 方法请求我们的任务资源的第二个版本。这是一个用来返回单独一个任务的函数:

  • from flask import abort@app.route(/todo/api/v1.0/tasks/<int:task_id>, methods=[GET])def get_task(task_id):

  •    task = filter(lambda t: t[id] == task_id, tasks)

  •    if len(task) == 0:

  •        abort(404)

  •    return jsonify({task: task[0]})

  • 第二个函数有些意思。这里我们得到了 URL 中任务的 id,接着 Flask 把它转换成 函数中的 task_id 的参数。

    我们用这个参数来搜索我们的任务数组。如果我们的数据库中不存在搜索的 id,我们将会返回一个类似 404 的错误,根据 HTTP 规范的意思是 “资源未找到”。

    如果我们找到相应的任务,那么我们只需将它用 jsonify 打包成 JSON 格式并将其发送作为响应,就像我们以前那样处理整个任务集合。

    调用 curl 请求的结果如下:

  • $ curl -i http://localhost:5000/todo/api/v1.0/tasks/2

  • HTTP/1.0 200 OK

  • Content-Type: application/json

  • Content-Length: 151

  • Server: Werkzeug/0.8.3 Python/2.7.3

  • Date: Mon, 20 May 2013 05:21:50 GMT


  • {

  •  "task": {

  •    "description": "Need to find a good Python tutorial on the web",

  •    "done": false,

  •    "id": 2,

  •    "title": "Learn Python"

  •  }

  • }

  • $ curl -i http://localhost:5000/todo/api/v1.0/tasks/3

  • HTTP/1.0 404 NOT FOUND

  • Content-Type: text/html

  • Content-Length: 238

  • Server: Werkzeug/0.8.3 Python/2.7.3

  • Date: Mon, 20 May 2013 05:21:52 GMT


  • <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

  • <title>404 Not Found</title>

  • <h1>Not Found</h1>

  • <p>The requested URL was not found on the server.</p><p>If you     entered the URL manually please check your spelling and try again.</p>

  • 当我们请求 id #2 的资源时候,我们获取到了,但是当我们请求 #3 的时候返回了 404 错误。有关错误奇怪的是返回的是 HTML 信息而不是 JSON,这是因为 Flask 按照默认方式生成 404 响应。由于这是一个 Web service 客户端希望我们总是以 JSON 格式回应,所以我们需要改善我们的 404 错误处理程序:

  • from flask import make_response@app.errorhandler(404)def not_found(error):

  •    return make_response(jsonify({error: Not found}), 404)

  • 我们会得到一个友好的错误提示:

  • $ curl -i http://localhost:5000/todo/api/v1.0/tasks/3

  • HTTP/1.0 404 NOT FOUND

  • Content-Type: application/json

  • Content-Length: 26

  • Server: Werkzeug/0.8.3 Python/2.7.3

  • Date: Mon, 20 May 2013 05:36:54 GMT


  • {

  •  "error": "Not found"

  • }

  • 接下来就是 POST 方法,我们用来在我们的任务数据库中插入一个新的任务:

  • from flask import request@app.route(/todo/api/v1.0/tasks, methods=[POST])def create_task():

  •    if not request.json or not title in request.json:

  •        abort(400)

  •    task = {

  •        id: tasks[-1][id] + 1,

  •        title: request.json[title],

  •        description: request.json.get(description, ""),

  •        done: False

  •    }

  •    tasks.append(task)

  •    return jsonify({task: task}), 201

  • 添加一个新的任务也是相当容易地。只有当请求以 JSON 格式形式,request.json 才会有请求的数据。如果没有数据,或者存在数据但是缺少 title 项,我们将会返回 400,这是表示请求无效。

    接着我们会创建一个新的任务字典,使用最后一个任务的 id + 1 作为该任务的 id。我们允许 description 字段缺失,并且假设 done 字段设置成 False。

    我们把新的任务添加到我们的任务数组中,并且把新添加的任务和状态 201 响应给客户端。

    使用如下的 curl 命令来测试这个新的函数:

  • $ curl -i -H "Content-Type: application/json" -X POST -d {"title":"Read a book"} http://localhost:5000/todo/api/v1.0/tasks

  • HTTP/1.0 201 Created

  • Content-Type: application/json

  • Content-Length: 104

  • Server: Werkzeug/0.8.3 Python/2.7.3

  • Date: Mon, 20 May 2013 05:56:21 GMT


  • {

  •  "task": {

  •    "description": "",

  •    "done": false,

  •    "id": 3,

  •    "title": "Read a book"

  •  }

  • }

  • 注意:如果你在 Windows 上并且运行 Cygwin 版本的 curl,上面的命令不会有任何问题。然而,如果你使用原生的 curl,命令会有些不同:

  • curl -i -H "Content-Type: application/json" -X POST -d "{"""title""":"""Read a book"""}" http://localhost:5000/todo/api/v1.0/tasks

  • 当然在完成这个请求后,我们可以得到任务的更新列表:

  • $ curl -i http://localhost:5000/todo/api/v1.0/tasks

  • HTTP/1.0 200 OK

  • Content-Type: application/json

  • Content-Length: 423

  • Server: Werkzeug/0.8.3 Python/2.7.3

  • Date: Mon, 20 May 2013 05:57:44 GMT


  • {

  •  "tasks": [

  •    {

  •      "description": "Milk, Cheese, Pizza, Fruit, Tylenol",

  •      "done": false,

  •      "id": 1,

  •      "title": "Buy groceries"

  •    },

  •    {

  •      "description": "Need to find a good Python tutorial on the web",

  •      "done": false,

  •      "id": 2,

  •      "title": "Learn Python"

  •    },

  •    {

  •      "description": "",

  •      "done": false,

  •      "id": 3,

  •      "title": "Read a book"

  •    }

  •  ]

  • }

  • 剩下的两个函数如下所示:

  • @app.route(/todo/api/v1.0/tasks/<int:task_id>, methods=[PUT])def update_task(task_id):

  •    task = filter(lambda t: t[id] == task_id, tasks)

  •    if len(task) == 0:

  •        abort(404)

  •    if not request.json:

  •        abort(400)

  •    if title in request.json and type(request.json[title]) != unicode:

  •        abort(400)

  •    if description in request.json and type(request.json[description]) is not unicode:

  •        abort(400)

喜欢阅读
  • 宠无止禁:辰少撩妻无下限

    宠无止禁:辰少撩妻无下限

    六年前,沈小晚只是一个普通的女生,李逸辰却是炙手可热的校草。那时候,沈小晚喜欢的人还不是李逸辰。李逸辰曾问她:“我到底哪里不好?到底哪里比不上他?”沈小晚想了想,对呀,李逸辰明明比谁都好,可是两个人却怎么也磨合不到一起去。多年以后,当李逸辰成为沈小晚的顶头上司。当李逸辰终于不再甘于当一个默默的守护者,霸道的站出来为她擦泪为她遮风挡雨,并强制揽她入怀的时候。她说:“如果有一天我会带给你无尽的灾难,你还会继续陪我走下去吗?”他拥着她坚定的回道:“只要你抓紧我,不放手,别回头,我永远在你的身后。”

  • 邪王绝宠:腹黑特工小毒妃

    邪王绝宠:腹黑特工小毒妃

    她,是22世纪的超高级王牌特工,却在遭遇惺惺相惜的队友出卖后,带着22世纪组织给配备的尖端设备和技术,意外穿越到某个不知名的时代的草包丑逼身上。当草包丑逼再次从泥泞中爬起来的时候,很多人的命运,甚至那个世界,都开始悄然变化了……他,是天颐国的战神王爷,是国泰民安的保护神,有心之人却容不得这样的人存在……他腹黑冷漠,却唯独对她……一天晚上,某只妖孽醉意微醺地爬进某女的闺房,“本王要向你请教一个问题!”“嗯,什么问题?”“找出下列重复的字。”“这有什么难的?问吧!”某女像看智障一样的眼光看着他。“你是不是喜欢我。”“是!”……感觉不对劲啊??某女懵逼了。“嗯,好巧,本王也是。”然后妖孽俯身封住了某女的嘴,不给她再反对的机会……

  • 豪门强宠:替身小娇妻

    豪门强宠:替身小娇妻

    楚明月替自己的妹妹嫁入豪门,嫁给那个世人眼中的残废,本以为自己的一生再没有什么希望乐趣。没想到“残废”叶薄渊噎死人不偿命的话,随时可以让人暴走!“夫人,我可是病人,你要给我暖床。”

  • 我的异世老婆

    我的异世老婆

    祖传玉佩闪光,牛逼少年登场!一块神秘玉佩、一个来自异界的美女,一场旷世奇缘……少年秦默的生活得到了翻天覆地的改变……

  • 乱世求仙

    乱世求仙

    兵王重生玄幻世界,手握最BUG生物系统。《道德经》、《推背图》,名人古籍手中具现;智慧、敏锐,于千里运筹帷幄;手揽星辰,脚踏悬河,当世美女皆在怀中!兵王叶枫,十方地狱,乱世求仙,剑破亿魔,身写传说!

  • 前夫复婚请排队

    前夫复婚请排队

    三年前,秦郁宁爱惨了沈牧风,三年后他回赠她家破人亡。她利落离婚,可是他却纠缠不休。秦郁宁冷笑:“沈总,我们已经离婚了。”男人低头,声音低沉暗哑:“那又如何?”他是A市最高贵的男人,翻手为云覆手为雨不过顷刻间,有什么得不到?更何况是一个被自己抛弃的女人。秦郁宁笑得妩媚,精致的眉眼微微上挑,葇荑推开男人的胸膛:“不如何,前夫,请排队。”

  • 晨如朝露爱如霜

    晨如朝露爱如霜

    我忍着小腹传来的剧痛,抬头看了一眼浴室里的那个男人。他跟其他的人不同,虽然已经年近三十可身材却依旧保持的很好,宽阔的肩膀上肌肉线条分明,就连翘起的臀肌都泛着金黄的小麦色。感受到我灼热的目光,顾景程转头冷冷的瞥了我一眼,薄唇轻启发出了一声毫不遮掩的嘲讽:“还想要一次?没满足么?”看着刚刚经过了一场激烈的“战斗”,空气中满是暧昧的气息的房间,我有些恍惚,跟做梦一样。

  • 抓不住的一指流沙

    抓不住的一指流沙

    一场手术导致苏慕瑶丧生,梁安自此身败名裂,被爱了十二年的男人亲手送进了监狱,生不如死。三年后男人依旧要让她背负着杀人犯的称号永远活在地狱中。而这一切不过是因为她错付了真心,爱上了一个她不该去爱的男人。

  • 猜你喜欢
  • python制作api接口
  • python如何调用api
  • python语音生成api
  • python语音api
  • python api文档
  • python api
  • aspose python api
  • python win32api
  • python调用api
  • python调用百度api
  • 热门推荐
  • 秩和检验表
  • qt5.6 vs2010
  • 爱奇艺兑换
  • 惠州紫金华府并购私募
  • 天才少年刘汉清
  • 儿童动画 知乎
  • pop love4结尾
  • 天选之子
  • XXOO萝莉动态图
  • google earth谷歌地球
  • 工字钢翼缘厚度
  • c 根据ip获取主机名
  • 江山耕读农场电话
  • 多芯屏蔽线
  • kinkikids2018演唱会
  • 内存扩展器汉化版
  • qq农场怎么打开
  • surface pro4gis
  • 晶振两端电压
  • 张光北老婆
  • All Right Reserved 完美网