HTTP response status codes described in this section indicate whether a specific HTTP request has been successfully completed. Refer to their descriptions below when integrating WebSpellChecker into your applications and testing REST API. This section covers: Server version request formatUse the following format for your request URL:
Cloud version request formatUse the following template for your request URL:
Response StructureThe response structure below is applicable to all error messages you may receive. The difference depends on the command used and the message returned.
400 Bad RequestThe HTTP 400 Bad Request response status code indicates that the server cannot or will not process the request due to something that is perceived to be a client error. Possible Cause
RemediationCheck the command correctness:
For example, the following command has a syntax error in "check_spelling" command name:
Remediation for the example above is to specify a correct command name.
For example, the command is unspecified:
Remediation for the example above is to specify the command value. For example, the parameter key is invalid:
Remediation for the example above is to specify a correct parameter key. 403 ForbiddenThe HTTP 403 Forbidden client error status response code indicates that the server understood the request but refuses to authorize it. Possible Cause Some issues usages or occurrences d in the response, for example:
Remediation In most cases an error description provides the exact cause of the issue and solution on how to fix the issue in response on your side. Example of incorrect customer ID:
Example of expired customer ID:
Remediation: request a new/valid secure customer ID. Example of the list of unallowed domains:
Remediation: Verify the subscription covers the domain where you are using WebSpellChecker. Example of the subscription key which is either turned off or does not exist yet:
Remediation: Contact our support team for details. 500 Internal Server ErrorThe HTTP 500 Internal Server Error server error response code indicates that the server encountered an unexpected condition that prevented it from fulfilling the request. Possible Cause This error response is a generic "catch-all" response. Usually, this indicates the server cannot find a better 5xx error code to response. This error usually denotes some situation when the server is not aware of how to handle it properly. It can be for example, any exceptions of the server logic including all hardware issues. Remediation For the moment, the only option to fix the issue with such request responses is to contact our support team at [email protected] 503 Service UnavailableThis parameter is applicable for WebSpellChecker Server version only. You may encounter this error in the following cases:
Verify the server license and update/request new license if it is necessary. Also contact our support team at [email protected] |