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

    Eshelf REST APIs return "Invalid URI Syntax" errors when using API Explorer.

    1. Last updated
    2. Save as PDF
    • Product: Primo
    • Product Version: February 2016 Release
    • Relevant for Installation Type:  Dedicated-Direct, Direct, Total Care

     

    Symptoms

    When using API Explorer to create Primo Eshelf REST APIs, an error is always returned for GET, POST, PUT, & DELETE methods:

     

    {
   "error": "Invalid URI syntax for target endpoint: Illegal character in path at index 64: https://api-na.hosted.exlibrisgroup.com/primo/v1/eshelf/pparker/
  {
    path : .+
  }" 
}

    This is caused because the path parameter {path : .+} is not substituted correctly by API Explorer.

    Defect Status

    The Eshelf REST API is actually working correctly here.

    The problem is with the API Explorer, and a Defect is open with API Explorer software vendor.

    Replication Steps

    1. Sign in to Developers Network.
    2. Go to API Explorer - https://developers.exlibrisgroup.com...a/api-explorer
    3. Select API = Primo eShelf (beta)
    4. Select Resource = /primo/v1/eshelf/{userid}/{path : .+}
    5. Select Method = does not matter
    6. Select appropriate API Application & Authentication (API Key)
    7. Complete Eshelf path parameter value
    8. Complete userid parameter value
    9. Leave inst parameter value blank
    10. Click Execute Request button
    11. "Invalid URI Syntax..." error is returned in Response tab

     

    clipboard_e222d424b0229590a92a5d6386b903366

    Workaround

    1. On Request tab, click Add Parameter
    2. Name=path : .+
    3. Value=<your desired path>
    *to DELETE an item, use <your desired path>/<pnxId>
    1. select Parameter Type=Template
    2. Click Add, Execute Request

     

    clipboard_e38e98a260caefe04f94b28d62bf4e04b

     

    clipboard_e13646cfeb09ceb647016b5b25857ea4f

     

    This technique will work with GET, POST, PUT, & DELETE Eshelf API methods.

     

     

     

     

    • Article last edited: 20-April-2016