🚀 Preview

In-Depth Analysis of the Salary Management API

“Boss, stop using Excel for payroll! Today, we will use 50 lines of Python to build a RESTful little powerhouse that calculates better than the finance lady—FastAPI Salary Management API! It not only helps you store payroll in the cloud but also allows one-click account checking and instant retrieval of the latest records. Take a sip of coffee, and in three seconds, it’s done. The boss no longer has to worry about me secretly changing the numbers!”

📚 Article Navigation (Well-structured and clear hierarchy)

Introduction (already provided)
Global Overview: Project Structure & Tech Stack
Step-by-step Breakdown of 6+ Core Modules① Entry File and FastApp Initialization② Pydantic Data Models (Request/Response)③ Simulated Database and Global Variables④ POST /salary/submit Salary Submission⑤ GET /salary/records Full Query⑥ GET /salary/latest Latest Record⑦ Exception Handling and HTTPException⑧ Startup Method & Swagger Documentation
Conclusion: Key Points & Project Goals
Bonus: Real-World Expansion Ideas

2️⃣ Global Overview: Project Structure & Tech Stack

salary_api/
├─ main.py              # All code in this article
├─ requirements.txt     # fastapi uvicorn
└─ README.md            # Optional documentation

Tech Stack in a nutshell:

FastAPI — Asynchronous high-performance web framework, automatically generates Swagger documentation;
Pydantic — Type validation and serialization, rejects dirty data;
Python 3.8+ — Native asynchronous support, plenty of syntactic sugar.

3️⃣ Step-by-step Breakdown of 6+ Core Modules

① Entry File and FastApp Initialization

from fastapi import FastAPI, HTTPException
from pydantic import BaseModel
from datetime import date
from typing import List, Optional

# Initialize FastAPI application
app = FastAPI(title="Salary Management API", version="1.0")

Hierarchical Analysis

Lines 1-4: Importing the essentials, standard three-part structure: framework, validation, date, generics.
Line 7: Instantiating the FastAPI object, which sets up the “company door” and labels it (title & version) for easy Swagger recognition.

② Pydantic Data Models (Request/Response)

class SalarySubmit(BaseModel):
    amount: float              # Salary amount (required)
    date: date                 # Submission date (required)
    remark: Optional[str] = None  # Remark (optional)

class SalaryRecord(SalarySubmit):
    id: int                    # Record ID (included in response)

Hierarchical Analysis

SalarySubmit: Pure “input” model, the frontend/client only needs to fill in these three items;

amount: float — Directly rejects strings like “five thousand”, must be 5000.00;
date: date — ISO format 2025-09-04, Pydantic helps convert to Python date;
Optional[str] = None — Remark can be null, a blessing for the lazy.

SalaryRecord: Inherits + extends, adds database primary key id, used for returning to the frontend, reflecting the classic design of “response has more fields than request”.

③ Simulated Database and Global Variables

salary_db: List[SalaryRecord] = []
next_id = 1

Hierarchical Analysis

salary_db: In-memory List, serves as the simplest “financial ledger”. It will be cleared upon process restart; for production, switch to PostgreSQL;
next_id: Auto-incrementing primary key, global variables may conflict under high concurrency, but it’s sufficient for the demo.

④ POST `/salary/submit` Salary Submission

@app.post("/salary/submit", response_model=SalaryRecord)
async def submit_salary(salary: SalarySubmit):
    global next_id
    # 1) Parameter validation
    if salary.amount &lt;= 0:
        raise HTTPException(status_code=400, detail="Salary amount must be positive")

    # 2) Business logic processing
    record = SalaryRecord(id=next_id, **salary.dict())
    salary_db.append(record)
    next_id += 1

    # 3) Return response
    return record

Hierarchical Analysis

Route Decorator

@app.post(...) registers the function in the FastAPI routing table;
response_model=SalaryRecord tells the framework “return this format”, automatically generating JSON Schema.

Function Signature

async def: Coroutine syntax, FastAPI natively supports asynchronous IO;
salary: SalarySubmit: Dependency injection, automatically deserialized by Pydantic.

Business Logic Trilogy

① Parameter validation:amount <= 0 directly raises a 400 error, avoiding “losing money for the boss”;
② Data persistence: constructs SalaryRecord and appends to the list;
③ Return: FastAPI automatically serializes the object to JSON.

⑤ GET `/salary/records` Full Query

@app.get("/salary/records", response_model=List[SalaryRecord])
async def get_salary_records():
    return salary_db

Hierarchical Analysis

Extremely simple read operation, directly returns the “ledger” to the frontend.
Type hint List[SalaryRecord] allows Swagger documentation to generate array examples, frontend developers will call it professional.

⑥ GET `/salary/latest` Latest Record

@app.get("/salary/latest", response_model=SalaryRecord)
async def get_latest_salary():
    if not salary_db:
        raise HTTPException(status_code=404, detail="No salary records available")
    return max(salary_db, key=lambda x: x.date)

Hierarchical Analysis

Empty Database Protection: if not salary_db raises a 404 in advance, avoiding max() crashing.
max + lambda: One line of code finds the most recent date record, very Pythonic.
Response Model: still SalaryRecord, maintaining consistency in interface contracts.

⑦ Exception Handling and HTTPException

Although there are only two instances of raise HTTPException in the code, FastAPI automatically translates exceptions into JSON, for example:

{
  "detail": "Salary amount must be positive"
}

Hierarchical Analysis

Semantic Status Codes: 400 client error, 404 resource not found;
Unified Format: The frontend only needs to access the detail field to show a toast, reducing communication costs.

⑧ Startup Method & Swagger Documentation

# 1. Install dependencies
pip install fastapi uvicorn

# 2. Run the service
uvicorn main:app --reload

Access the browser at http://127.0.0.1:8000/docs to see the interactive Swagger:

On the left, /salary/submit → Try it out → Input JSON and click Execute;
On the right, automatically generated curl command, supports export to Postman.

4️⃣ Conclusion: Key Points & Project Goals

Dimension	Key Points	Goal Achievement
Framework	FastAPI routing, dependency injection, asynchronous	Write high-performance interfaces in 5 minutes
Validation	Pydantic models, Optional fields	Reject dirty data, zero disputes between frontend and backend
Data	In-memory List simulation, global auto-increment ID	Quick prototyping, painless migration to SQL later
Exceptions	HTTPException, status codes	RESTful semantics, no surprises for the frontend
Documentation	Swagger/OpenAPI auto-generation	No need to write a line of Markdown, interfaces are still understandable
Deployment	uvicorn hot reload	300% increase in development efficiency

5️⃣ Bonus: Real-World Expansion Ideas

Database: SQLAlchemy + SQLite/MySQL, switch with three lines of code;
Authentication: OAuth2 password flow, financial data must be encrypted;
Pagination: limit/offset to avoid returning 100,000 records at once;
Statistical Reports: Add /salary/report?month=2025-09, aggregate total for the month;
Frontend Integration: Vue + Axios can be set up in 5 minutes, allowing the boss to view salaries in real-time on their phone.

The full text is over 3000 words, guiding you step by step from 0 to 1 to create a runnable, viewable, and salary-increasing little powerhouse. Hurry up and throw the code into the terminal, let the boss experience the smoothness of “cloud finance”!

Click 【Follow + Collect】 to get the latest practical code examples

Python 20-day learning plan

7-day Python learning plan

Python implementation of similar Postman calls

Python implementation of LAN file sharing tool

Python implementation of online calligraphy generator

Python implementation of leaf carving images

Python ID photo generator with multiple sizes

Python implementation of background replacement for portrait ID photos

Python development of custom EXE packaging program

Python implementation of seal generator

Python implementation of simple rent summary calculator

Python implementation of Nezha typing balloon game

Python implementation of batch certificate production factory

Python one-click generation of stamped Word leave requests

Python quick PS image color picker and other editors

Python implementation of batch certificate production factory

Python quick PS image color picker and other editors

Python implementation of custom color picker

Python implementation of automatic watercolor sketch

Python implementation of creative drawing board code

Using Python to create a Chinese character stroke query tool: from GUI interface to stroke animation implementation

Python implementation of meme maker

Python implementation of Chinese chess mini-game

Python implementation of seal generator

Python simulation of Jinshan typing software

Python super practical Markdown to rich text tool — full code analysis

Python implementation of snake game source code analysis

Python implementation of QR code generation

Python implementation of video player

Python implementation of seal generator

Python implementation of online seal making

Python + AI to implement a simple intelligent voice assistant

Python implementation of simple notepad

Python implementation of Markdown to HTML tool code

Python implementation of creative drawing board code

Python implementation of simple drawing tool code

Python implementation of video player

Python implementation of simple notepad

Python implementation of the connect-the-dots game code analysis

Python implementation of simple computer process manager

A super practical tool in Python – word frequency statistics tool

Python simple crawler weather tool

Python scheduled task reminder tool

Python “Guess the Number Game Code Analysis”

Python “Simple Calculator Code Analysis”

Python + AI online document generation assistant

Python “Password Generator Code Analysis”

Python | + AI to implement a simple intelligent voice assistant

Python implementation of simple drawing tool code

Python implementation of Markdown to HTML

Python implementation of video player

Python implementation of the connect-the-dots game code analysis

Python implementation of volcanic AI call to generate stories

Python implementation of Doubao AI call to generate stories

Python implementation of simple notepad

Python implementation of simple computer process manager

【Practical 1】

Python: QR code generator
Python-pgame implementation of maze
Python – implementation of weather clock assistant
Python-QrCode implementation of various QR codes
Python-pyglet implementation of HarmonyOS clock
Python-pickle parsing to get WeChat friend information
Python-wxPy initial version implementation of WeChat message bombing
Python implementation of Eight Trigrams Starry Sky Clock
Python implementation of National Day red flag avatar effect
Python-PIL implementation of adding icons to specified positions on images

【Practical 2】

Python-wxPy initial version implementation of WeChat message bombing
Python-PIL library Image class parsing
Python-tlinter implementation of simple student management system
Python-itChat implementation of WeChat message push
Python implementation of Pdf to Word
Python – implementation of automatic couplet generation assistant
Py2Exe another way of packaging
Python-tts generating voice conversion assistant
python-win32 etc. to automatically add exe to computer startup options
python implementation of desktop video recording
PySimpleGUI-checkboxPython implementation of image cropping into a grid
python packaging into exe file
Python-faker generating virtual data
python implementation of player Python-FastApi simple implementation
python crawling Douban movie reviews
Python crawling public account article collection

【Practical 3】

python implementation of simple flower order
python – get images to guess idioms
python-menu menu implementation
Python-pySimpleGUI implementation of interface
Python – color image conversion to white outline
Python-moviepy – implementation of audio and video player
Python operating SQLite database
Python-PySimpleGUI implementation of menu
python-Tkinter implementation of personalized signature
Python-WordCloud cloud word map
Python-customTkinter usage
Python-tkinter (down)
Python-tkinter (middle)
python-tkinter (1)
Python implementation of video assistant

【Practical 4】

Python implementation of video assistant
Python-flask-1: building the main page
Python ttkbootstrap interface
python-PyQt5 implementation of image display and simple reader
Configuring Qt Designer and Pyuic on Pycharm
Python PIL implementation of cropping and generating images of one inch and two inches
Python crawling Jinshan dictionary query results
python implementation of generating personalized QR codes
AI human-computer battle version of Gomoku game (AI + pygame implementation)
python implementation of garbage classification query tool
python – implementation of menu
Python domain application: automated testing
Python domain application: web development
Python domain application: automated operations

Implementing a Salary Management API with Python

Complete Code

from fastapi import FastAPI, HTTPExceptionfrom pydantic import BaseModelfrom datetime import datefrom typing import List, Optional# Initialize FastAPI applicationapp = FastAPI(title="Salary Management API", version="1.0")# Data model definition (request/response format)class SalarySubmit(BaseModel):amount: float  # Salary amount (required)date: date  # Submission date (required)remark: Optional[str] = None  # Remark (optional)class SalaryRecord(SalarySubmit):id: int  # Record ID (included in response)# Simulated database (can be replaced with a real database in actual projects)salary_db: List[SalaryRecord] = []next_id = 11. Submit salary (POST request)@app.post("/salary/submit", response_model=SalaryRecord)async def submit_salary(salary: SalarySubmit):global next_id# Validate salary amount is positiveif salary.amount &lt;= 0:raise HTTPException(status_code=400, detail="Salary amount must be positive")# Save recordrecord = SalaryRecord(id=next_id, **salary.dict())salary_db.append(record)next_id += 1return record2. Query all salary records (GET request)@app.get("/salary/records", response_model=List[SalaryRecord])async def get_salary_records():return salary_db3. Query latest salary record (GET request)@app.get("/salary/latest", response_model=SalaryRecord)async def get_latest_salary():if not salary_db:raise HTTPException(status_code=404, detail="No salary records available")return max(salary_db, key=lambda x: x.date)# Startup instructions:1. Install dependencies: pip install fastapi uvicorn2. Run the service: uvicorn main:app --reload3. Access documentation: http://127.0.0.1:8000/docs

Implementing a Salary Management API with Python

🚀 Preview

In-Depth Analysis of the Salary Management API

📚 Article Navigation (Well-structured and clear hierarchy)

2️⃣ Global Overview: Project Structure & Tech Stack

3️⃣ Step-by-step Breakdown of 6+ Core Modules

① Entry File and FastApp Initialization

② Pydantic Data Models (Request/Response)

③ Simulated Database and Global Variables

④ POST `<span>/salary/submit</span>` Salary Submission

⑤ GET `<span>/salary/records</span>` Full Query

⑥ GET `<span>/salary/latest</span>` Latest Record

⑦ Exception Handling and HTTPException

⑧ Startup Method & Swagger Documentation

4️⃣ Conclusion: Key Points & Project Goals

5️⃣ Bonus: Real-World Expansion Ideas

Leave a Comment Cancel reply

🚀 Preview

In-Depth Analysis of the Salary Management API

📚 Article Navigation (Well-structured and clear hierarchy)

2️⃣ Global Overview: Project Structure & Tech Stack

3️⃣ Step-by-step Breakdown of 6+ Core Modules

① Entry File and FastApp Initialization

② Pydantic Data Models (Request/Response)

③ Simulated Database and Global Variables

④ POST <span>/salary/submit</span> Salary Submission

⑤ GET <span>/salary/records</span> Full Query

⑥ GET <span>/salary/latest</span> Latest Record

⑦ Exception Handling and HTTPException

⑧ Startup Method & Swagger Documentation

4️⃣ Conclusion: Key Points & Project Goals

5️⃣ Bonus: Real-World Expansion Ideas

Related posts

Leave a Comment Cancel reply

④ POST `<span>/salary/submit</span>` Salary Submission

⑤ GET `<span>/salary/records</span>` Full Query

⑥ GET `<span>/salary/latest</span>` Latest Record