Link Domain Data, Filters and Services for Hartford Public Library

Data Legend

Libraries maintain some of the richest descriptive metadata, curated content, and services in the world. For the Web to connect with libraries, we must share in a way the Web understands. The following icons are used to represent the types of data Libraries publish to the Web.

Data Enrichment

Libraries share not only their catalogs but additional enrichment data that makes their catalogs even better. The following reflect the visual cues used to represent this information.

Bibframe Resource (e.g. Person) from the library catalog
Bibframe Resource (e.g. Person) from a premium data enrichment services such as EBSCO NoveList
Bibframe Resource (e.g. Person) from an open data enrichment service
Bibframe Resource (e.g. Person) from library catalog that has been enriched from a premium data enrichment service.

Bibframe Resource Types

Bibframe resource types provide common control points to connect data in the Library and across the Web. The following types are derived from a Library catalog.

An Agent resource
An Annotation resource
A Category resource
A Collection resource
A Concept resource
An Event such as Copyright or Publication event
A Family resource
A Form resource
An Instance resource
An Item resource
A Meeting resource
An Organization resource
A Person resource
A Place resource
A Series resource
A Temporal resource
A Topic resource
A Work resource

Work Types

Specific Work (content) types include

A Moving Image resource
A Books resource
A Language Material resource
A Mixed Materials resource
A Still Image resource
A Audio resource
A Sounds resource
A Nonmusical resource
A Visual Materials resource
A Computer Files resource
A Software resource
A Continuing Resources resource
A Music resource
A Notated Music resource
A Cartography resource
A Musical resource
A Multimedia resource
A Three Dimensional Object resource
A Kit resource

Instance Types

Specific Instance (carrier) types include

A Map resource
A Electronic resource
A Globe resource
A Tactile Material resource
A Projected Graphic resource
A Microform resource
A Nonprojected Graphic resource
A Motion Picture resource
A Kit resource
A Notated Music resource
A Sound Recording resource
A Print resource
A Video Recording resource

Item Types

Item types are aggregate types based on specific combinations of Work (Content) and Instance (Carrier). Item types include

Audio Book
Sound Recording
Movie
Electronic Resource / Electronic Book
Periodical
Series
Music
Print Book

Data Filters

The Web was not the first proposed system for widespread dissemination on a network, but it succeeded where many other initiatives failed. The Web won out because of its very simple protocol (HTTP), simple addressing mechanism (URL) and very simple (and permissive) content format (HTML). Libraries are now through the Library.Link Network funneling more such content to the Web than any other single event. This content also happens to be enriched with data, but that fact should not detract from the basic character of the Web.

The Library.Link network offers this enriched data as a service, but in order to handle the unprecedented scale of what we're doing, we rely on the most basic principles of Web architecture, which are the reasons for its success. We organize the interface to this content and rich data into a handful of resource types, based on prevailing access patterns within libraries, with a handful of filters within each type. We have undertaken this design with a lot of consideration for how the work of building applications on library resources can be best balanced across publishing, syndication and subscription. Incidentally, we hope more projects recognize that this is the right-sized and best proven approach to Web "APIs".

Types

Type filters follow the simple pattern of

http://hartpublic.library.link/resource/type/filter

The following are the set Type filters currently available

/all
Example
http://hartpublic.library.link/portal/all
Result
Returns the list of URI, label pairs for all of the resources of a particular type
Remark
Resource types include any Bibframe Resource Type such as Person, Place, Family, Work etc. The full list of Items can accessed with the resource type Portal.

Resources

Each resource on a Libraries Link Domain has a Local Link Identifier that you obtain by appending its ID (such as B4gN9Duqv3s) to the Library's Link domain namespace http://hartpublic.library.link/resource/

For example, the Local Link Identifier for Rowling, J. K. is http://hartpublic.library.link/resource/B4gN9Duqv3s/. Note that this identifier refers to the real-world person. However, it is possible to use this Identifer to access data about Rowling, J. K. by simply using it as a URL.

Data Filters over resources follow the simple pattern of

http://hartpublic.library.link/resource/identifier/filter

The following are the set Resource filters currently available

/this
Example
http://hartpublic.library.link/resource/B4gN9Duqv3s/this
Result
Returns the resource
/related-by-category
Example
http://hartpublic.library.link/resource/qx4o1wB3CmU/related-by-category
Result
Returns the carousel of items related to the Category
/related-by-concept
Example
http://hartpublic.library.link/resource/L3sQNWHcitU/related-by-concept
Result
Returns the carousel of items related to the Concept
/related-by-authority
Example
http://hartpublic.library.link/resource/PcoP1rxX70c/related-by-authority
Result
Returns the carousel of items related to the Authority
/related-by-agent
Example
http://hartpublic.library.link/resource/RYeuRFRrXpw/related-by-agent
Result
Returns the carousel of items related to the Agent
/related-by-collection
Example
http://hartpublic.library.link/resource/gtgGhrcC838/related-by-collection
Result
Returns the carousel of items that are members of the Collection
/related-by-place
Example
http://hartpublic.library.link/resource/qm0O08yWEY4/related-by-place
Result
Returns the carousel of items related to the Place
/related-by-work
Example
http://hartpublic.library.link/resource/_6HewLxq3bk/related-by-work
Result
Returns the carousel of items that are related to the Work
/related-by-even
Example
http://hartpublic.library.link/resource/Tk-bwfw65Cc/related-by-event
Result
Returns the carousel of items that are related to the Event

Items

Items are a special type of Resource. An item in a Libraries Link Domain has a Local Link Identifier that you obtain by appending its ID (such as D5Pq8-7u4w8) to the Library's Link domain namespace http://hartpublic.library.link/portal/-/

Data Filters over items follow the simple pattern of

http://hartpublic.library.link/portal/-/identifier/filter

Data Filters over items include all of the Resource Data Filters and the following

/borrow
Example
http://hartpublic.library.link/portal/Fantastic-beasts--where-to-find-them-Newt/D5Pq8-7u4w8/borrow
Result
Redturns the target service where the item may be borrowed.
/locations
Example
http://hartpublic.library.link/portal/Fantastic-beasts--where-to-find-them-Newt/D5Pq8-7u4w8/locations
Result
Returns the Library locations that offer the Item.

Identifier Services

Each resource on a Libraries Link Domain has a Local Link Identifier. Some of these resources are known by additional community or vendor supplied identifiers such as an International Standard Book Number (ISBN) or a control number assigned by a Library vendor. Identifier Resolver and Mapping services are provided to make it easier to access these Local Link resources by these additional identifiers.

Resolvers

Identifier Resolvers are provided by the Libraries Link Domain to more easily access Library.Link resources directly and accelerate the data consumption by 3rd party applications.

Identifier Resolvers follow the simple pattern of

http://hartpublic.library.link/id/scheme/identifier/resource

The following are the set Identifier Resolvers currently available.

/id/isbn/
Example
http://hartpublic.library.link/id/isbn/9780312938994/resource
Result
Returns a redirect to the resource that is additionally known by the ISBN number
9780312938994
.
/id/recordNumber/
Example
http://hartpublic.library.link/id/recordNumber/.b12998539/resource
Result
Returns a redirect to the resource that is additionally known by the Record Number as
.b12998539
.
Note: Record Number is required to be URL encoded.

Mappings

Identifier Mappings are provided to accelerate access to Local Link resources by 3rd party applications. These mappings include key, value mappings that map identifiers to Local Link resources. Identifier Mappings follow the simple pattern of

http://hartpublic.library.link/id/scheme/all

The following are the set Identifier Mappings currently available.

Note: Identifier Mappings return the full list of typed identifiers that map to library resources and are intended for 3rd party developers. Users accessing these service through a browser may have difficulty loading the amount of data available.
/id/isbn/all
Example
http://hartpublic.library.link/id/isbn/all
Result
Returns the complete list of ISBN identifier to Library.Link local identifier mappings.
/id/lccn/all
Example
http://hartpublic.library.link/id/lccn/all
Result
Returns the complete list of LCCN identifier to Library.Link local identifier mappings.
/id/recordNumber/all
Example
http://hartpublic.library.link/id/recordNumber/all
Result
Returns the complete list of Record identifier to Library.Link local identifier mappings.
/id/systemNumber/all
Example
http://hartpublic.library.link/id/systemNumber/all
Result
Returns the complete list of System identifier to Library.Link local identifier mappings.
/id/publisherNumber/all
Example
http://hartpublic.library.link/id/publisherNumber/all
Result
Returns the complete list of Publisher identifiers to Library.Link local identifier mappings.
Processing Feedback ...
http://hartpublic.library.link/data.html
hartpublic.library.link
crawl=CC-MAIN-2018-39
38324
application/http; msgtype=response
sha1:M6N2DA6Q3TLIV46ZRRYSQ5M4EPOPYA2Q
<urn:uuid:b81e3141-2899-4d8c-942c-1aa0944de66d>
2018-09-24T04:25:57Z
148.62.44.33
text/html
sha1:NFEEIFL2TM2IACC5QRKMMT3MDJCWEI6A
<urn:uuid:39bf8973-5452-4f8f-aa3b-8e7352fb11a1>
http://hartpublic.library.link/data.html
response
<urn:uuid:b91a504e-1aad-4143-8278-8b690ecb78e2>
isPartOf: CC-MAIN-2018-39
publisher: Common Crawl
description: Wide crawl of the web for September 2018
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-157-187-24.ec2.internal
software: Apache Nutch 1.15 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 0.11-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: http://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/