Skip to main content
ExLibris
  • Subscribe by RSS
    • Back
    Voyager
    Ex Libris Knowledge Center

    URL returned by Patron API is invalid

    1. Last updated
    2. Save as PDF
    • Article Type: General
    • Product: Voyager
    • Product Version: 8.1.2

    Problem Symptoms:
    * RESTful Patron API returns 3 additional API calls in response; "Records" call returns 404 error.
    http://127.0.0.1:7014/vxws/patron/<patron_id>/records?patron_homedb=1@<db_key>"/><institution id="LOCAL"><instName>Columbia University Libraries</instName></institution></patron></response>

    response:
    HTTP Status 404 -
    type Status report
    message
    description The requested resource () is not available.
    Apache Tomcat/7.0.14

    Cause:
    This behavior is caused by Known Issue 16384-20577.

    Resolution:
    Fixed in Voyager 8.2.2.

    Additional Information

    Replication steps:
    1. Make a call to vxws for patron information:
    http://<ip>:<port>/vxws/patron/<patron_id>?patron_homedb=1@<db_key>
    2. vxws will return XML with 3 additional API calls:
    <response>
    <reply-text>ok</reply-text>
    <reply-code>0</reply-code>
    <patron>
    <info type="Circulation Actions" href= "http:// <ip>:<port>/vxws/patron/<patron_id>/circulationActions?patron_homedb=1@<db_key>" />
    <info type="Patron Information" href= "http:// <ip>:<port>/vxws/patron/<patron_id>/patronInformation?patron_homedb=1@<db_key>" />
    <info type="Records" href= "http:// <ip>:<port>/vxws/patron/<patron_id>/records?patron_homedb=1@<db_key>" />
    <institution id="LOCAL">
    <instName>Voyager Library Training Database</instName>
    </institution>
    </patron>
    </response>
    3. The first two API calls ? Circulation Actions & Patron Information ? correspond to documented Voyager RESTful APIs and return additional patron information.
    4. The third API call ? Records ? is not documented, and returns error:
    HTTP Status 404 -
    type Status report
    message
    description The requested resource () is not available.
    Apache Tomcat/7.0.14

    Workaround: None needed for Ex Libris applications that use these APIs; if using for own developments, do not use this API call.

    Please note that Voyager Support has a very limited ability to assist with the Voyager APIs.  We can help identify the APIs that might be useful to you, and provide basic troubleshooting aid.  Voyager-L and Developer Network  are useful resources for obtaining additional assistance.

    Category: (Voyager)

    • Article last edited: 10/8/2013