FastAPI--快速入门(1)

发布时间：2020-06-18 09:41:30编辑：admin阅读（4073）

    一、简介

    FastAPI 是一个高性能 Web 框架，用于构建 API。

    主要特性：

    • 快速：非常高的性能，与 NodeJS 和 Go 相当

    • 快速编码：将功能开发速度提高约 200％ 至 300％

    • 更少的错误：减少约 40％ 的人为错误

    • 直观：强大的编辑器支持，自动补全无处不在，调试时间更少

    • 简易：旨在易于使用和学习，减少阅读文档的时间。

    • 简短：减少代码重复。

    • 稳健：获取可用于生产环境的代码，具有自动交互式文档

    • 基于标准：基于并完全兼容 API 的开放标准 OpenAPI 和 JSON Schema

     

    官方链接：https://fastapi.tiangolo.com/

     

    二、第一个Hello World

    注意事项，因为FastAPI仅支持Python3.6+的API，所以需要再Python3.6+的环境进行学习实践！

    安装依赖

    FastAPI - 是一个现代的，快速（高性能）python web框架

    pip3 install fastapi

    uvicorn - 主要用于加载和提供应用程序的服务器.

    pip3 install uvicorn

     

    Hello World

    main.py

    import uvicorn
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

if __name__ == '__main__':
    uvicorn.run(app='main:app', host="127.0.0.1", port=8000, reload=True, debug=True)

    参数解释：

    app = FastAPI() 用于实例化 FastAPI类，通常app这个变量会设置成全局的，至少在当前模块作用域有效。

    @app.get("/") 是一个装饰器，在这里的作用是将普通的Python函数变成一个get请求接口 ("/")表示url是根目录主页。

     至于函数里的代码就很好理解了，定义了一个函数，然后return 了一个字典，表示接口被访问时默认会返回一个JSON格式的数据回去（当然也可以return别的数据格式，例如字符串、列表等）。

    uvicorn.run(app='main:app', host="127.0.0.1", port=8000, reload=True, debug=True)

    表示使用uvicorn启动当前目录下main.py这个文件里的app实例

    reload=True的意思是文件内容变更后自动重启服务，便于开发调试。

     

    启动程序，使用pycharm启动，或者在命令行模式下启动

    python3 main.py

     

    访问首页

    http://127.0.0.1:8000/

     

    效果如下：

    1.png

     

     

    API文档交互

    http://127.0.0.1:8000/docs

    你将会看到自动生成的API交互文档(由 Swagger UI提供):

    1.png

     

     

    可选的API文档

    http://127.0.0.1:8000/redoc

     

    你将会看到自动生成的可选的API文档(由(provided by ReDoc提供):

    1.png

     

     

     

    本文参考链接：

    http://www.zyiz.net/tech/detail-119883.html

    https://www.jianshu.com/p/94710ed35b92

     


关键字：

上一篇： LVS+Keepalive双机热备

下一篇： FastAPI--路由(2)