Errors
Zoho Backstage uses HTTP status codes to indicate the outcome of API calls, providing insight into whether an operation was successful or encountered issues. The status codes are categorized into different classes, each conveying specific information:
2xx Success Codes: These codes indicate successful operations. When a 2xx code is returned, it signifies that the request was processed successfully, confirming actions like "confirmed," "validated," or "accepted." For example, a 200 OK response means the request was handled successfully.
4xx Client Error Codes: These codes represent errors caused by issues on the client’s side, such as invalid input or unauthorized access. Common phrases associated with 4xx errors include "bad request" or "unauthorized." For example, a 400 Bad Request indicates that the request could not be processed due to incorrect inputs.
5xx Server Error Codes: These codes suggest problems on the server’s side, such as internal server issues. A 500 Internal Server Error indicates a temporary problem that prevents the server from processing the request. Phrases like "service unavailable" or "server error" describe these situations.
Status Codes and Descriptions
Status Code | Description | Example Message |
200 | Ok | The request was successful. |
400 | Bad request | No Brand Found (The server cannot process the request due to client-side issues.) |
401 | Unauthorized (Invalid AuthToken) | We're sorry, either this resource has been deleted or you don't have permission to access it. |
404 | URL Not Found | Please provide a valid URL. |
500 | Internal Error | The server encountered an unexpected condition that prevented it from fulfilling the request. |
200 - Successful Response
Copied{
"id": "19308574",
"name": "Master Class",
"domain": "masterclass.zohobackstage.com",
"is_portal_default": true,
"owner_name": "zylker"
}
400 - Bad Request
Copied{
"status_code": "400",
"message": "No Brand Found"
}
401 - Resource Not Found
Copied{
"status_code": "401",
"message": "We're sorry, either this resource has been deleted or you don't have permission to access it."
}
404 - URL Not Found
Copied{
"status_code": "404",
"message": "Please provide a valid url"
}