Error Messages
No Result Found
If the service cannot find a match for the article you specify, you will receive the following message: No Result Found. Technically, this is not an error message.
Here is an example of a response to a request for which no matching data were found:
<?xml version="1.0" encoding="UTF-8" ?> <response xmlns="http://www.isinet.com/xrpc42" src="app.id=API Demo"> <fn name="LinksAMR.retrieve" rc="OK"> <map> <map name="cite_1"> <map name="WOS"> <val name="message">No Result Found</val> </map> </map> </map> </fn> </response>
Response Errors
<?xml version="1.0" encoding="UTF-8" ?> <response xmlns="http://edclinuxqa9.isinet.com:17010/esti/xrpc" src="app.id=API Demo"> <fn name="LinksAMR.bogusname" rc="Server.methodNotFound"> <error code="Server.methodNotFound">LinksAMR.methodname</error> </fn> </response>
The error codes and strings for response level errors are:
Error Code(s) |
Error String |
Meaning |
---|---|---|
Server.methodNotFound |
LinksAMR.methodname |
Specific service requested is not valid or unrecognized |
Server.invalidRequest |
Could not parse request... |
Request contains invalid XML. See error string for details. |
Server.internalError |
Internal Server Error |
Service encountered an internal error. |
Authentication Errors
Example:
<?xml version="1.0" encoding="UTF-8" ?> <response xmlns="http://edclinuxqa9.isinet.com:17010/esti/xrpc" src="app.id=API Demo"> <fn name="LinksAMR.retrieve" rc="Server.authentication"> <error code="Server.authentication">No matches returned for Username</error> </fn> </response>
The error codes and strings for response level errors are:
Error Code(s) |
Error String |
Meaning |
---|---|---|
Server.authentication |
No matches returned for Username |
Username and/or password provided in request not recognized. |
Server.authentication |
No matches returned for IP Address |
IP Address provided in request not recognized. |
Server.authentication |
Invalid Username |
Password in request is not valid for username provided. |
Server.authentication |
No Portal entitlement found for IP Address |
Username/password or IP not entitled for portal |
Entitlement Errors
Example:
<?xml version="1.0" encoding="UTF-8" ?> <response xmlns="http://edclinuxqa9.isinet.com:17010/esti/xrpc" src="app.id=API Demo"> <fn name="LinksAMR.retrieve" rc="Server.authorization"> <error code="Server.authorization">com.isinet.esti.AuthorizationException: Server.authorization - Not entitled for 'citingArticlesURL(CitingArtLinkAllowed)' in product 'WOS'.</error> </fn> </response>
The error codes and strings for entitlement level errors are:
Error Code(s) |
Error String |
Meaning |
---|---|---|
Server.authorization |
(no prefix) Not authorized for product: AMR |
Your subscription does not entitle you to retrieve a requested data element or product. Consult your terms of service to verify which data elements you may request. |
Server.authorization |
(prefix) Not entitled for product 'WOS' |
You have requested data from Web of Science but your service agreement does not authorize you to receive data from Web of Science. |
Server.authorization |
(prefix) Not entitled for product 'JCR' |
You have requested data from Journal Citation Reports but your service agreement does not authorize you to receive data from Journal Citation Reports. |
Server.authorization |
(prefix) Illegal service 'NoSuchService' requested. |
The correct name of the service is LinksAMR.retrieve. Check that the atttribute value in the <fn> element at the beginning of your request is LinksAMR.retrieve. |
Server.authorization |
(prefix) Not entitled for 'doi(DOIAllowed), citingArticlesURL (CitingArtLinkAllowed), relatedRecordsURL (RelRecLinkAllowed)' in product 'WOS' |
You are not entitled to retrieve the specified data elements. Check the terms of your service agreement to verify that you are entitled to receive the data you requested. |
Server.authorization |
Query 'cite_1' contains one or more non-AMRLite request fields. AMRLite request fields are 'ut, pmid, doi' |
Your subscription entitles you to specify articles in a request by identifiers only. The service cannot process a request that includes only bibliographic data to identify citations. |
Note: It is not an error if a requested citation falls outside of your product subscription. For example, no error is returned if you provide a citation to an article published in 1990 in the request, but your product subscription is limited to 2000-present. In this case, you will receive an empty response.
Citation Errors
Example:
<?xml version="1.0" encoding="UTF-8" ?> <response xmlns="http://edclinuxqa9.isinet.com:17010/esti/xrpc" src="app.id=API Demo"> <fn name="LinksAMR.retrieve" rc="Server.invalidInput"> <error code="Server.invalidInput">Query 'xxxx' is empty</error> </fn> </response>
The error codes and strings for citation level errors are:
Error Code(s) |
Error String |
Meaning |
---|---|---|
Server.invalidInput |
Query 'xxxx' is empty |
An empty <map> element was encountered in the LOOKUP DATA section of the request. |
Server.invalidInput |
Citation entry missing name. |
A <map> element is missing the 'name' attribute in the LOOKUP DATA section of the request. |
Server.invalidInput |
Number of cites specified in request exceeds max allowed 50. |
The number of items specified in a single request cannot exceed 50. If you want data for more than 50 articles, you must submit multiple requests. |
JCR Error
Example:
<?xml version="1.0" encoding="UTF-8" ?> <map> <map name="cite_1"> <map name="JCR"> <val name="error">Server.JournalCitation - JCR database error occurred.</val> </map>
The error code and string for the JCR error are:
Error Code(s) |
Error String |
Meaning |
---|---|---|
Server.JournalCitation |
JCR database error occurred. |
A server-side JCR database error occurred. Contact the Global Customer Support Center. |