Types of API Errors
Errors can originate from validation, authentication, authorization, resource existence, business conflicts, rate limits, dependency failures, timeouts, or unexpected server faults.
Do not expose internal stack traces, SQL statements, secrets, filesystem paths, or dependency details to clients in production.
A useful API distinguishes between errors that clients can fix and errors that require server-side intervention.
Error Categories
400:
Malformed or invalid requestThe request cannot be processed as submitted.
401:
Authentication failureCredentials are missing or invalid.
403:
Authorization failureThe caller lacks permission.
409:
ConflictThe request conflicts with current resource state.
422:
Semantic validation failureThe syntax is valid but business validation fails.
500:
Unexpected server errorThe server encountered an unhandled failure.