其他分享
首页 > 其他分享> > FastAPI 学习之路(十二)接口几个额外信息和额外数据类型

FastAPI 学习之路(十二)接口几个额外信息和额外数据类型

作者:互联网

系列文章:

  FastAPI 学习之路(一)fastapi--高性能web开发框架

  FastAPI 学习之路(二)

  FastAPI 学习之路(三)

  FastAPI 学习之路(四)

  FastAPI 学习之路(五)

      FastAPI 学习之路(六)查询参数,字符串的校验

  FastAPI 学习之路(七)字符串的校验

    FastAPI 学习之路(八)路径参数和数值的校验

  FastAPI 学习之路(九)请求体有多个参数如何处理?

  FastAPI 学习之路(十)请求体的字段

     FastAPI 学习之路(十一)请求体 - 嵌套模型 

一、额外信息

我们有这样的一个需求,我们希望可以看到接口的一个简单的请求示例展示在我们的接口文档中,应该如何实现呢。我们看下如何实现的:
from typing import Optional

from fastapi import FastAPI
from pydantic import BaseModel
app = FastAPI()
class Item(BaseModel):
    name: str
    description: Optional[str] = None
    price: float
    tax: Optional[float] = None
    class Config:
        schema_extra = {
            "example": {
                "name": "DEMO",
                "description": "DEMO",
                "price": 20,
                "tax": 0.5,
            }
        }
@app.post("/items/")
def return_item( item: Item):
    results = { "item": item}
    return results

那么我们请求下试试。

 

 接口满足我们的请求,我们看下接口文档是否有请求的示例。

 

 

 接口文档是正常有这个的示例。代码中使用Config 和 schema_extra 为Pydantic模型声明一个简单的示例。

其实我们在Field也会可以实现一个额外的信息,比如我们增加一个example字段,我们看下如何实现的,带来什么样的效果

 
from typing import Optional
from fastapi import FastAPI
from pydantic import BaseModel,Field
app = FastAPI()
class Item(BaseModel):
    name: str
    description: Optional[str] = None
    price:float = Field(..., example=600)
    tax: Optional[float] = Field(None, example=0.5)

@app.post("/items/")
def return_item( item: Item):
    results = { "item": item}
    return results

 我们看下效果,正常的接口请求没有变动。

 

  我们看下接口的文档。文档在解析的时候,会解析出来这个额外的信息。

 

 当然像Body,Path等也都可以增加这些参数。

二、 额外数据类型

到目前为止,您一直在使用常见的数据类型,如:

但是您也可以使用更复杂的数据类型。

您仍然会拥有现在已经看到的相同的特性:

其他数据类型

下面是一些你可以使用的其他数据类型:

  下面是一个接口操作的示例,其中的参数使用了上面的一些类型。

from typing import Optional
from uuid import UUID
from fastapi import Body, FastAPI
from datetime import datetime, time, timedelta
app = FastAPI()
@app.put("/items/{id}")
async def read_items(
    item_id: UUID,
    start_time: Optional[datetime] = Body(None),

    end_time: Optional[datetime] = Body(None),


    after: Optional[timedelta] = Body(None),

):
    start_process = start_time 
    duration = end_time - start_process
    return {
        "id": item_id,
        "start_datetime": start_time,
        "end_datetime": end_time,
        "after": after,
        "start_process": start_process,
        "duration": duration,
    }

 那么我们看下接口文档的请求。

 

 

 UUId来源        http://www.uuid.online/可以生成。

        这样就是我们利用了这些参数的一个请求。

 

 

文章首发在公众号,欢迎关注。

标签:额外,请求,FastAPI,数据类型,datetime,item,str,Optional
来源: https://www.cnblogs.com/leiziv5/p/15416250.html