anti/DECNET
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs: tag API endpoints for better organization

Browse Source
This commit is contained in:
anti
2026-04-09 01:58:54 -04:00
parent 30edf9a55d
commit a3b92d4dd6
3 changed files with 11 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
decnet/web/api.py
View File

@@ -145,7 +145,7 @@ class BountyResponse(BaseModel):
data: list[dict[str, Any]]
@app.post("/api/v1/auth/login", response_model=Token)
@app.post("/api/v1/auth/login", response_model=Token, tags=["Authentication"])
async def login(request: LoginRequest) -> dict[str, Any]:
_user: Optional[dict[str, Any]] = await repo.get_user_by_username(request.username)
if not _user or not verify_password(request.password, _user["password_hash"]):
@@ -167,7 +167,7 @@ async def login(request: LoginRequest) -> dict[str, Any]:
}
@app.post("/api/v1/auth/change-password")
@app.post("/api/v1/auth/change-password", tags=["Authentication"])
async def change_password(request: ChangePasswordRequest, current_user: str = Depends(get_current_user)) -> dict[str, str]:
_user: Optional[dict[str, Any]] = await repo.get_user_by_uuid(current_user)
if not _user or not verify_password(request.old_password, _user["password_hash"]):
@@ -181,7 +181,7 @@ async def change_password(request: ChangePasswordRequest, current_user: str = De
return {"message": "Password updated successfully"}
@app.get("/api/v1/logs", response_model=LogsResponse)
@app.get("/api/v1/logs", response_model=LogsResponse, tags=["Logs"])
async def get_logs(
limit: int = Query(50, ge=1, le=1000),
offset: int = Query(0, ge=0),
@@ -200,7 +200,7 @@ async def get_logs(
}
@app.get("/api/v1/bounty", response_model=BountyResponse)
@app.get("/api/v1/bounty", response_model=BountyResponse, tags=["Bounty Vault"])
async def get_bounties(
limit: int = Query(50, ge=1, le=1000),
offset: int = Query(0, ge=0),
@@ -219,7 +219,7 @@ async def get_bounties(
}
@app.get("/api/v1/logs/histogram")
@app.get("/api/v1/logs/histogram", tags=["Logs"])
async def get_logs_histogram(
search: Optional[str] = None,
start_time: Optional[str] = None,
@@ -237,12 +237,12 @@ class StatsResponse(BaseModel):
deployed_deckies: int
@app.get("/api/v1/stats", response_model=StatsResponse)
@app.get("/api/v1/stats", response_model=StatsResponse, tags=["Observability"])
async def get_stats(current_user: str = Depends(get_current_user)) -> dict[str, Any]:
return await repo.get_stats_summary()
@app.get("/api/v1/deckies")
@app.get("/api/v1/deckies", tags=["Fleet Management"])
async def get_deckies(current_user: str = Depends(get_current_user)) -> list[dict[str, Any]]:
return await repo.get_deckies()
@@ -251,7 +251,7 @@ class MutateIntervalRequest(BaseModel):
mutate_interval: int | None
@app.post("/api/v1/deckies/{decky_name}/mutate")
@app.post("/api/v1/deckies/{decky_name}/mutate", tags=["Fleet Management"])
async def api_mutate_decky(decky_name: str, current_user: str = Depends(get_current_user)) -> dict[str, str]:
from decnet.mutator import mutate_decky
success = mutate_decky(decky_name)
@@ -260,7 +260,7 @@ async def api_mutate_decky(decky_name: str, current_user: str = Depends(get_curr
raise HTTPException(status_code=404, detail=f"Decky {decky_name} not found or failed to mutate")
@app.put("/api/v1/deckies/{decky_name}/mutate-interval")
@app.put("/api/v1/deckies/{decky_name}/mutate-interval", tags=["Fleet Management"])
async def api_update_mutate_interval(decky_name: str, req: MutateIntervalRequest, current_user: str = Depends(get_current_user)) -> dict[str, str]:
from decnet.config import load_state, save_state
state = load_state()
@@ -275,7 +275,7 @@ async def api_update_mutate_interval(decky_name: str, req: MutateIntervalRequest
return {"message": "Mutation interval updated"}
@app.get("/api/v1/stream")
@app.get("/api/v1/stream", tags=["Observability"])
async def stream_events(
request: Request,
last_event_id: int = Query(0, alias="lastEventId"),
@@ -333,7 +333,7 @@ async def stream_events(
class DeployIniRequest(BaseModel):
ini_content: str = Field(..., min_length=5, max_length=512 * 1024)
@app.post("/api/v1/deckies/deploy")
@app.post("/api/v1/deckies/deploy", tags=["Fleet Management"])
async def api_deploy_deckies(req: DeployIniRequest, current_user: str = Depends(get_current_user)) -> dict[str, str]:
from decnet.ini_loader import load_ini_from_string
from decnet.cli import _build_deckies_from_ini