Add operation_id to all auth route endpoints

This change adds an `operation_id` to all endpoints in the authentication routes. This improves API documentation clarity and ensures unique identifiers for each route, aiding in tools that rely on OpenAPI specs.
This commit is contained in:
2025-03-05 09:16:08 +01:00
parent 162e586e13
commit f87e0dd3b0

View File

@@ -23,14 +23,14 @@ router = APIRouter()
logger = logging.getLogger(__name__) logger = logging.getLogger(__name__)
@router.post("/register", response_model=UserResponse, status_code=status.HTTP_201_CREATED) @router.post("/register", response_model=UserResponse, status_code=status.HTTP_201_CREATED, operation_id="register")
async def register_user( async def register_user(
user_data: UserCreate, user_data: UserCreate,
db: Session = Depends(get_db) db: Session = Depends(get_db)
) -> Any: ) -> Any:
""" """
Register a new user. Register a new user.
Returns: Returns:
The created user information. The created user information.
""" """
@@ -51,14 +51,14 @@ async def register_user(
) )
@router.post("/login", response_model=Token) @router.post("/login", response_model=Token, operation_id="login")
async def login( async def login(
login_data: LoginRequest, login_data: LoginRequest,
db: Session = Depends(get_db) db: Session = Depends(get_db)
) -> Any: ) -> Any:
""" """
Login with username and password. Login with username and password.
Returns: Returns:
Access and refresh tokens. Access and refresh tokens.
""" """
@@ -100,14 +100,14 @@ async def login(
) )
@router.post("/login/oauth", response_model=Token) @router.post("/login/oauth", response_model=Token, operation_id='login_oauth')
async def login_oauth( async def login_oauth(
form_data: OAuth2PasswordRequestForm = Depends(), form_data: OAuth2PasswordRequestForm = Depends(),
db: Session = Depends(get_db) db: Session = Depends(get_db)
) -> Any: ) -> Any:
""" """
OAuth2-compatible login endpoint, used by the OpenAPI UI. OAuth2-compatible login endpoint, used by the OpenAPI UI.
Returns: Returns:
Access and refresh tokens. Access and refresh tokens.
""" """
@@ -147,14 +147,14 @@ async def login_oauth(
) )
@router.post("/refresh", response_model=Token) @router.post("/refresh", response_model=Token, operation_id="refresh_token")
async def refresh_token( async def refresh_token(
refresh_data: RefreshTokenRequest, refresh_data: RefreshTokenRequest,
db: Session = Depends(get_db) db: Session = Depends(get_db)
) -> Any: ) -> Any:
""" """
Refresh access token using a refresh token. Refresh access token using a refresh token.
Returns: Returns:
New access and refresh tokens. New access and refresh tokens.
""" """
@@ -183,7 +183,7 @@ async def refresh_token(
) )
@router.post("/change-password", status_code=status.HTTP_200_OK) @router.post("/change-password", status_code=status.HTTP_200_OK, operation_id="change_password")
async def change_password( async def change_password(
current_password: str = Body(..., embed=True), current_password: str = Body(..., embed=True),
new_password: str = Body(..., embed=True), new_password: str = Body(..., embed=True),
@@ -192,7 +192,7 @@ async def change_password(
) -> Any: ) -> Any:
""" """
Change current user's password. Change current user's password.
Requires authentication. Requires authentication.
""" """
try: try:
@@ -219,7 +219,7 @@ async def change_password(
) )
@router.get("/me", response_model=UserResponse) @router.get("/me", response_model=UserResponse, operation_id="get_current_user_info")
async def get_current_user_info( async def get_current_user_info(
current_user: User = Depends(get_current_user) current_user: User = Depends(get_current_user)
) -> Any: ) -> Any: