Briefle words · Code & architecture
HTTP status code
The three-digit number every web response starts with, saying whether the request worked and, if not, whose fault it was.
Say it to an AI
FastAPI POST /appointments that returns 201 Created with the new appointment. Use proper HTTP status codes for failures via HTTPException: 404 if the slot doesn't exist, 409 if it's already taken, 422 if the start time is in the past. Never return 200 with an ok/error flag.
How an expert would brief the stronger version of “Booking endpoint”.
See it
Try it as a puzzle →The API endpoint a clinic's patient app calls to book an appointment slot.
Why: A always returns the default 200; B returns 201, 404, 409 or 422 depending on what happened.
Related words
Room 5 · APIs & data
Learn “HTTP status code” in a five-minute lesson