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>
If you find it necessary to report errors, please include the calaisRequestID, which will help us investigate the problem.
Error messages are summarized here:
|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.|