Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: jsonp callback parameter doesn't work for holdings or availabilty calls. Base syntax for availability only returns title and author

WIth the new ALMA system undergirding HOLLIS, holding and availability information is provided separately.

Holdings

URL request syntax

The base syntax is:

http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/{HOLLIS_number}


With optional jsonp callback parameter:

http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/{HOLLIS_number}?jsonp={callback function name}

 



Parameters

Parameter

Value

Description

HOLLIS_number

record ID

ID number of the bibliographic record.  This may be either the Alma (MMS) ID, or, for backward compatibility, the old HOLLIS ("Aleph") ID

jsonp

Callback function name

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

Information provided in the response

Besides the total_record_count, the following is provided

  • Alma (MMS) ID
  • Author
  • Barcode
  • Call number

  • Description

  • Is the holding in a temporary location?

  • Library code

  • Location (permanent)
  • Publication place and publisher
  • Temporary call number
  • Temporary library
  • Temporary location
  • Temporary policy
  • Title

Sample URL

Requesting holdings information for HOLLIS record ID 011500528:
http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/011500528

http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/011500528?jsonp=holdings

Sample response

URL: http://webservices.lib.harvard.edu/rest/v3/hollis/holdings/001252867?jsonp=hold for Rabbit redux / John Updike, 1971

Code Block
languagejs
themeEclipse
title Response
collapsetrue
hold({"items": {
  "item": [
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044051800407,
      "call_number": "PS3571.P4 R27 1971x",
      "description": {},
      "in_temp_location": false,
      "library": "QUA",
      "location": "HIGH",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044051838985,
      "call_number": "PS3571.P4 R27x 1971",
      "description": {},
      "in_temp_location": false,
      "library": "LAM",
      "location": "GEN",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044021584776,
      "call_number": "ALB 7214.321.20",
      "description": {},
      "in_temp_location": false,
      "library": "WID",
      "location": "GEN",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044079932836,
      "call_number": "*AC95.Up174R3.1971 (A)",
      "description": {},
      "in_temp_location": false,
      "library": "HOU",
      "location": "GEN",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": "HH3MQZ",
      "call_number": "*AC95.Up174R3.1971 (B)",
      "description": {},
      "in_temp_location": false,
      "library": "HOU",
      "location": "HD",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    },
    {
      "alma_id": 990012528670203941,
      "author": "Updike, John",
      "barcode": 32044135104537,
      "call_number": "AC95.Up174R3.1971 (C)",
      "description": {},
      "in_temp_location": false,
      "library": "HOU",
      "location": "HD",
      "publication": {
        "place": "New York :",
        "publisher": "Knopf"
      },
      "temp_call_number": {},
      "temp_library": {},
      "temp_location": {},
      "temp_policy": {},
      "title": "Rabbit redux /"
    }
  ],
  "total_record_count": 6
}})

Availability

URL request syntax

The base syntax is:

hthttp://webservices.lib.harvard.edu/rest/avail/hollis/{HOLLIS_number}

With optional jsonp callback parameter:

http://webservices.lib.harvard.edu/rest/avail/hollis/{HOLLIS_number}?jsonp={callback function name}

 


Parameters

Parameter

Value

Description

HOLLIS_number

record ID

ID number of the bibliographic record.  This may be either the Alma (MMS) ID, or, for backward compatibility, the old HOLLIS ("Aleph") ID

jsonp

Callback function name

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

Information provided in the response


Beside the Author, MMS ID, and Title, each holding has the following information:

  • Call number
  • Holding ID (note that subsequent development may find a use for this number)
  • Library name and code
  • Location
  • Number not available
  • Status
  • Total items

Sample URL

Requesting availability information for bib record 990012528670203941  (Rabbit Redux)

http://webservices.lib.harvard.edu/rest/avail/hollis/990012528670203941?jsonp=av

Response

Code Block
languagejs
themeFadeToGreyEclipse
collapsetrue
av({"availability": {
  "author": "Updike, John",
  "items": {"item": [
    {
      "callnumber": "*AC95.Up174R3.1971 (A)",
      "holding": 221798074030003941,
      "library": "Houghton Library (HOU)",
      "location": "GEN",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "*AC95.Up174R3.1971 (B)",
      "holding": 221798073930003941,
      "library": "Houghton Library (HOU)",
      "location": "Offsite Storage",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "AC95.Up174R3.1971 (C)",
      "holding": 221798073860003941,
      "library": "Houghton Library (HOU)",
      "location": "Offsite Storage",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "PS3571.P4 R27 1971",
      "holding": 221798073830003941,
      "library": "Kirkland House (KIR)",
      "location": "GEN",
      "nonAvail": {},
      "status": "check_holdings",
      "totalItems": {}
    },
    {
      "callnumber": "PS3571.P4 R27x 1971",
      "holding": 221798074120003941,
      "library": "Lamont Library (LAM)",
      "location": "GEN",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    },
    {
      "callnumber": "ALB 7214.321.20",
      "holding": 221798074080003941,
      "library": "Widener Library (WID)",
      "location": "Old Widener",
      "nonAvail": 0,
      "status": "available",
      "totalItems": 1
    }
  ]},
  "mmsid": 990012528670203941,
  "title": "Rabbit redux /"
}})

Table of Contents