python开发接口uvicorn方法启动FastAPI，postman调用接口

中年程序员一枚2025-12-13 15:00

python开发接口uvicorn方法启动FastAPI，postman调用接口

FastAPI 基于 ASGI 规范（异步网关接口），其应用实例 app 是一个ASGI 应用对象，而非普通函数。

通过 ASGI 服务器（uvicorn/gunicorn）启动应用，而非直接调用 app()

安装

复制代码

#pip install fastapi
#pip install uvicorn

uvicorn main:app --host 0.0.0.0 --port 8000

案例

复制代码

# main.py
from fastapi import FastAPI
import uvicorn

app = FastAPI()


# 示例1：GET接口（无参数）
@app.get("/hello")
def hello():
    return {"message": "Hello FastAPI"}

# 示例2：GET接口（带查询参数）
@app.get("/user/{user_id}")
def get_user(user_id: int, name: str = None):
    return {"user_id": user_id, "name": name}

# 示例3：POST接口（带JSON参数）
@app.post("/create-user")
def create_user(user: dict):
    return {"code": 200, "data": user, "msg": "创建成功"}

if __name__ == "__main__":
    # 启动服务：host=0.0.0.0 允许外部访问，port=8000
    uvicorn.run(app, host="0.0.0.0", port=8000)

启动

命令行启动（推荐）

uvicorn main:app --host 0.0.0.0 --port 8000

复制代码

postman调用接口

http://127.0.0.1:8000/hello