Moreinfo

General description:

This service returns links to cover images, back covers and archived full text for library materials. Cover images and all other additional information handled by the service, are placed in a separate repository and can be retrieved using various identifiers.

The service supports XML/SOAP-requests and REST-like URL-requests (see sample requests below).

In case of any discrepancy between the documentation on this page and the WSDL/XSD of a specific version of the Moreinfo web service, the WSDL/XSD is to be considered the authoritative source.

Versions:

Service URL: https://moreinfo.addi.dk/2.10/

WSDL: https://moreinfo.addi.dk/2.10/?wsdl

XSD: https://moreinfo.addi.dk/2.10/moreinfo.xsd

End-of-life date for versions older than 2.10 is December 1, 2017.

Test Access:

Currently not available.

Service operations:

The service has one operation: moreInfo.

The moreInfoRequest takes one or more identifiers and retrieves cover images and additional information for these. Available identifier types are FAUST (DanBib record ID), ISBN, PID (object identifier from Open Search) and local identifier (a combination of record ID and library code).

The URLs returned by the service are temporary and will work for 24-48 hours.

moreInfoRequest-parameters:

Parameter:

Must be present:

Repeatable:

Sub element of:

Description:

authentication

yes

no

moreInfoRequest

Parameters for identifying service requester

authenticationUser

yes

no

authentication

Service requester's user name

authenticationGroup

yes

no

authentication

Identifier of the service requester (most often a library number)

authenticationPassword

yes

no

authentication

Service requester's password

identifier

yes

yes

moreInfoRequest

Identifier of the record to retrieve additional information for

faust

if other identifier is not present

no

identifier

DanBib-identifier of bibliographic record for which cover image etc. is looked up

isbn

if other identifier is not present

no

identifier

Identifier of a book for which cover image etc. is looked up.

pid

...

no

identifier

Identifier of an Open Search-pbject

pidList

...

no

identifier

List of Open Search-pids, separated by |

localIdentifier

if other identifier is not present

no

identifier

Local identifier of material for which cover image etc. is looked up

libraryCode

if localIdentifier is present

no

identifier

Identifier of the agency which owns the bibliographic record identified with localIdentifier

outputType

no

no

moreInfoRequest

Set format of web service output. Possible values: xml, json, php. Default output format for SOAP and URL-requests is SOAP. Default output format for XML-requests is XML.

callBack

no

no

moreInfoRequest

JSON-callback. Only if used if outputType is set to json.

trackingId

no

no

moreInfoRequest

Identifier for tracking a request.


moreInfoResponse-parameters

Parameter:

Always present:

Repeatable:

Sub element/attribute of:

Description:

requestStatus

yes

no

moreInfoResponse

Status of request

statusEnum

yes

no

requestStatus

Status message. Possible values: ok, service_unavailable, error_in_request, authentication_error

errorText

no

no

requestStatus

Elaboration of error message

identifierInformation

no

yes

moreInfoResponse

Return information for each requested identifier

identifierKnown

yes

no

identifierInformation

Boolean indicating whether the requested identifier is known in the database. It does not guarantee that any additional information is available for the identifier.

identifier

yes

yes

identifierInformation

Identifier of the record to retrieve additional information for

faust

if other identifier is not present

no

identifier

DanBib-identifier of bibliographic record for which cover image etc. is looked up

isbn

if other identifier is not present

no

identifier

Identifier of a book for which cover image etc. is looked up.

pid

...

no

identifier

Identifier of an Open Search-object

localIdentifier

if other identifier is not present

no

identifier

Local identifier of material for which cover image etc. is looked up

libraryCode

if localIdentifier is present

no

identifier

Identifier of the agency which owns the bibliographic record identified with localIdentifier

coverImage

no

yes

identifierInformation

Link to cover image. Repeated for each available size and format. See attribute schema below

coverText

no

yes

identifierInformation

Currently not implemented. Additional text from cover.

colophon

no

yes

identifierInformation

Colophon from book

titlePage

no

yes

identifierInformation

Title page of book

tableOfContents

no

yes

identifierInformation

Currently not implemented. Table of contents from book

backPage

no

yes

identifierInformation

Back page of book

backImage

no

yes

identifierInformation

Back image of book

netArchive

no

yes

identifierInformation

Internet ressource

imageSize

no

no

coverImage, backImage

Attribute containing information about the size of cover image. Possible values: thumbnail, detail, detail_48, detail_128, detail_256, detail_42, detail_117, detail_207, detail_500. Number indicates the height of the image.

imageformat

no

no

coverImage, backImage

Attribute containing information about the file format of cover image. Possible values: jpeg, gif, pdf

informationFormat

no

yes

coverText, colophon, titlePage, tableOfContents, backPage, netArchive

Attribute containing information about the file format for additional information. Possible values: xml, html, pdf, epub

source

no

yes

coverImage, coverText, colophon, titlePage, tableOfContents, backPage, backImage, netArchive

Attribute containing additional source information.


Sample Requests:

Look up PID:
https://moreinfo.addi.dk/2.10/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&pid=870970-basis:29506914

Look up multiple PIDS (pidList):
https://moreinfo.addi.dk/2.10/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&pidList=870970-basis:29506914|870970-basis:29506906

Look up FAUST:
https://moreinfo.addi.dk/2.10/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&faust=29506906

Look up ISBN:
https://moreinfo.addi.dk/2.10/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&isbn=9788711396650

Result containing netArchive:
https://moreinfo.addi.dk/2.10/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&pid=870970-basis:52419344