Error Messages
Submitted by admin on Wed, 02/25/2009 - 13:37.
Error Messages
The OpenCalais Web Service response may indicate errors in submission or processing stages.
Error messages will be returned as an XML response in the following format:
<Error Method="ProcessText" CalaisSessionID="(Session ID here)" CalaisVersion="(Version Number here)">
<Exception> (Error Message Here) [SID= (Session ID here)]</Exception>
</Error>If you find it necessary to report errors, please include the calaisRequestID, which will help us investigate the problem.
Error messages are summarized here:
| Error Message | Description |
| Illegal Content-Type. | The field contentType (file extension – like XML, txt, HTML, etc.) is not known and includes characters that are forbidden in file name (the message includes the illegal value). |
| Your content appears to be of type HTML but was not submitted as such. Please specify this content-type when submitting HTML content. | The field contentType doesn't match the submitted content. Specifically HTML content needs to be submitted with the proper content type (TEXT/HTML). |
| paramsXML is invalid. | The params XML is invalid format. Either it is a NULL string or not legal XML string. |
| Missing a mandatory paramsXML item. | Specifically - The content type in the Params XML is missing. |
| Length has exceeded the allowed size. | For content it is limited to 100,000 characters. |
| Calais Backend-Server is Busy. Please try again later. | The Calais server is too busy. Wait at least 1 minute, and then try resubmitting the document. |
| Calais Backend-Server has accepted the document and has already started to process it, but was unable to finish its processing within the time limit. |
This error message is returned when the timeout has been reached.
|
| An error has occurred during an attempt to invoke the Calais Backend-Server: |
Error in the Calais tagging server. The error message is also returned. |
| Your content appears to be of type 'HTML' but was not submitted as such. Please specify this content-type when submitting HTML content. | This error message is returned if the content appears to be HTML but the user didn’t specify it through paramsXML. |
| Document conversion error. Please make sure that the content-type (passed through the paramsXML) matches this document contents. | The actual content sent to Calais does not match the type of content specified in the content type field, or the content string is NULL. |
| Internal Calais Backend-Server Error. | Internal error in the Calais tagging server. |
| Content is invalid | The exception occurs if the content string is empty or null. |