### 使用 Python FastAPI 创建 API 接口 为了使用 FastAPI 框架创建 API 接口，开发者需遵循一系列具体操作来构建高效的应用程序。 #### 安装必要的库 在开始之前，确保已安装 FastAPI 及其所需的依赖项。这可以通过命令行工具完成： ```bash pip install fastapi uvicorn ``` 上述命令会下载并安装 FastAPI 和 Uvicorn 服务器，Uvicorn 是用来启动 FastAPI 应用的服务端软件[^2]。 #### 初始化项目结构与导入模块 创建一个新的 Python 文件 `main.py` 并引入必要的包： ```python import uvicorn from fastapi import FastAPI, Depends, HTTPException from pydantic import BaseModel from typing import List ``` 定义应用程序实例以便后续添加路由处理函数： ```python app = FastAPI() ``` #### 构建简单的 GET 请求处理器 下面展示了一个非常基础的例子，它展示了如何设置一个返回 JSON 数据的简单路径操作函数： ```python @app.get("/") async def read_root(): return {"message": "Hello World"} ``` 此代码片段配置了一条根 URL 路径 `/` ，当访问该地址时将响应一条消息给客户端[^1]。 #### 启动应用服务 最后，在文件底部加入如下条件语句以允许直接通过 Python 解释器运行脚本： ```python if __name__ == "__main__": uvicorn.run(app, host="0.0.0.0", port=8000) ``` 这段代码使得可以在本地环境中测试新建立的 API 接口。 #### 添加 POST 方法支持用户注册/登录功能 对于更复杂的功能需求比如用户认证，则可能还需要额外的安全组件以及数据库交互逻辑。这里给出一个简化版的用户登录接口实现方式作为例子： 首先增加对密码哈希的支持和 JWT 编码解码能力: ```bash pip install python-jose[cryptography] passlib[bcrypt] ``` 接着修改之前的 `main.py` 来包含这些特性： ```python from datetime import timedelta, datetime from jose import jwt, JWTError from passlib.context import CryptContext from fastapi.security import OAuth2PasswordBearer, OAuth2PasswordRequestForm SECRET_KEY = "your_secret_key" ALGORITHM = "HS256" ACCESS_TOKEN_EXPIRE_MINUTES = 30 pwd_context = CryptContext(schemes=["bcrypt"], deprecated="auto") oauth2_scheme = OAuth2PasswordBearer(tokenUrl="token") class Token(BaseModel): access_token: str token_type: str fake_users_db = { "johndoe": { "username": "johndoe", "full_name": "John Doe", "email": "johndoe@example.com", "hashed_password": "$2b$12$qPQZkDqz7X9pLJfVHmY4OeWuBvGgKwRtFhNcTnEiMxSsCZyAaBbCcD", # example hash of 'secret' "disabled": False, } } def verify_password(plain_password, hashed_password): return pwd_context.verify(plain_password, hashed_password) def get_user(db, username: str): if username in db: user_dict = db[username] return UserInDB(**user_dict) def authenticate_user(fake_db, username: str, password: str): user = get_user(fake_db, username) if not user or not verify_password(password, user.hashed_password): raise HTTPException( status_code=status.HTTP_401_UNAUTHORIZED, detail="Incorrect username or password", headers={"WWW-Authenticate": "Bearer"}, ) return user @app.post("/token", response_model=Token) async def login_for_access_token(form_data: OAuth2PasswordRequestForm = Depends()): user = authenticate_user(fake_users_db, form_data.username, form_data.password) access_token_expires = timedelta(minutes=ACCESS_TOKEN_EXPIRE_MINUTES) access_token = create_access_token( data={"sub": user.username}, expires_delta=access_token_expires ) return {"access_token": access_token, "token_type": "bearer"} ... ``` 以上部分实现了基于用户名密码的身份验证机制，并发放带有有效期限制的令牌供前端调用其他受保护资源时携带验证身份之用[^3]。