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.