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.