HTTP Status Codes in Qualitia REST API
Qualitia REST APIs use standard HTTP status codes to indicate the outcome of API requests. These status codes are grouped into five categories based on the nature of the response:
1xx Information Responses
These codes indicate that the server has received the request and is continuing to process it. They are typically used during the initial stages of the client-server communication.
100 Continue: Indicates that the server has received the initial request and the client can continue sending the remaining part.
101 Switching Protocols: Informs the client that the server is switching to a different protocol as requested.
102 Processing: Indicates that the server is still processing the request but hasn’t completed it yet.
2xx Success Responses
These codes indicate that the client’s request was successfully received, understood, and processed.
200 OK: The request was successfully processed, and the requested data is returned in the response.
201 Created: The request was successful, and a new resource was created on the server.
204 No Content: The request was successfully processed, but no content is returned in the response.
3xx Redirection Responses
These codes indicate that further action is required from the client to complete the request, often involving a resource that has moved to a new location.
301 Moved Permanently: The requested resource has been permanently moved to a new URL. The client should update bookmarks and links.
303 See Other: The resource is available at a different URL, and the client should use a GET request to access it.
4xx Client Error Responses
These codes indicate issues with the client’s request, such as invalid input or unauthorized access.
400 Bad Request: The server cannot process the request due to malformed syntax or invalid input.
401 Unauthorized: The client must authenticate to access the requested resource.
403 Forbidden: The client is authenticated but does not have permission to access the requested resource.
404 Not Found: The requested resource could not be found on the server.
5xx Server Error Responses
These codes indicate that the server encountered an error while attempting to fulfill the client’s request.
500 Internal Server Error: A generic error indicating an unexpected server condition prevented the request from being processed.
502 Bad Gateway: The server, acting as a gateway, received an invalid response from an upstream server.
503 Service Unavailable: The server is temporarily unable to process the request, often due to high traffic or maintenance.
Notes
When interacting with the Qualitia REST APIs, understanding these status codes will help you troubleshoot and handle responses efficiently. Ensure proper handling of client errors (4xx) and server errors (5xx) to build robust integrations.