ILS-DI

GetAvailability

Given a set of bibliographic or item identifiers, returns a list with availability of the items associated with the identifiers.

Parameters

id (Required)

list of either bibliographic or item identifiers

id_type (Required)

defines the type of record identifier being used in the request, possible values:

• bib
• item

return_type (Optional)

requests a particular level of detail in reporting availability, possible values:

• bib
• item

return_fmt (Optional)

requests a particular format or set of formats in reporting availability

Example call

ilsdi.pl?service=GetAvailability&id=1+2+99999&id_type=item

Example response

<?xml version="1.0" encoding="ISO-8859-1" ?>
<dlf:collection
  xmlns:dlf="http://diglib.org/ilsdi/1.1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://diglib.org/ilsdi/1.1
    http://diglib.org/architectures/ilsdi/schemas/1.1/dlfexpanded.xsd">
  <dlf:record>
    <dlf:bibliographic id="1" />
    <dlf:items>
      <dlf:item id="1">
        <dlf:simpleavailability>
          <dlf:identifier>1</dlf:identifier>
          <dlf:availabilitystatus>available</dlf:availabilitystatus>
          <dlf:location>Bibliothèque Jean Prunier</dlf:location>
        </dlf:simpleavailability>
      </dlf:item>
    </dlf:items>
  </dlf:record>
  <dlf:record>
    <dlf:bibliographic id="2" />
    <dlf:items>
      <dlf:item id="2">
        <dlf:simpleavailability>
          <dlf:identifier>2</dlf:identifier>
          <dlf:availabilitystatus>available</dlf:availabilitystatus>
          <dlf:location>Bibliothèque Jean Prunier</dlf:location>
        </dlf:simpleavailability>
      </dlf:item>
    </dlf:items>
  </dlf:record>
  <dlf:record>
    <dlf:bibliographic id="99999" />
    <dlf:items>
      <dlf:item id="99999">
        <dlf:simpleavailability>
          <dlf:identifier>99999</dlf:identifier>

          <dlf:availabilitystatus>unknown</dlf:availabilitystatus>
          <dlf:availabilitymsg>Error: could not retrieve availability for this ID</dlf:availabilitymsg>
        </dlf:simpleavailability>
      </dlf:item>
    </dlf:items>
  </dlf:record>
</dlf:collection>