Skip to end of metadata
Go to start of metadata

PRESTO provides RESTful searching of HOLLIS Classic to enable use of the HOLLIS Classic Command Search functionality.

Authorization

All requests of this type are restricted to pre-registered IP addresses.

URL request syntax

The base syntax is:

http://webservices.lib.harvard.edu/rest/classic/search/{record_format}/{command}

Syntax for a JSONP request:

http://webservices.lib.harvard.edu/rest/classic/search/{record_format}/{command}?jsonp={callback function name}

Parameters

Parameter

Value

Description

record_format

dc, mods, marc

Specifies format of the returned record.

Results in dc (Dublin Core) format will include the maximum amount of information available (unlike HOLLIS dc, which includes minimal data).

mods provides a MODS 3.2 record, marc provides a MARCXML record. For items without MARC data (e,g. VIA data), returned format will be dc.

command

HOLLIS classic command string

The command string is constructed as described on the HOLLIS Classic Command Search page. Note that the command string should be URL encoded (e.g.: “=” is replaced by “%3D”, so that the command

WRD=(physics)

would be rendered as:

WRD%3D(physics)

jsonp

Callback function name

The name of the callback function to wrap around JSON data.  Example: ?jsonp=ws_results

Sample URL

A keyword search for physics:

http://webservices.lib.harvard.edu/rest/classic/search/dc/wrd=physics

Response

The response to a HOLLIS Classic search may contain links for moving to the next set of results, etc., as described below. You cannot limit or expand the number of results returned in a single call; this number is hard-coded at 25.

Any call to the PRESTO HOLLIS Classic search returns an XML document (or JSON version of it, if requested) with, minimally, the following elements.

Top level XML

For a HOLLIS Classic search, the top level elements in the returned XML look like this:

 

  • The value of <itemsPerPage> is fixed at 25.
  • If there are fewer than 26 results, the <pager> element is not present.
  • There may not be a <searchsuggestion> element

 

<item> Element Details

Each <item> element will resemble the <item> elements produced by a PRESTO HOLLIS Search.

<pager> Element Details

If there are more than 25 results, the <pager> element will be present, and contain sub elements. Below is an example from a results XML with 1000 results.

 

 

For the case above, to obtain the next 25 items that fulfill the search, the URL would be:
http://webservices.lib.harvard.edu/rest/classic/results/dc/937338/1000/26/50?wrd=physics
  • No labels