Skip to content
MichelLyck edited this page Mar 10, 2020 · 7 revisions

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. Current version:

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

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

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

Please note that versions older than 2.11 was closed on April 30, 2018.

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 (national bibliographic 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.

Note: Not more than 100 identifiers may be requested in a single call. If more are requested an error like

"Error in request validation. Error: Element '{http://oss.dbc.dk/ns/moreinfo}identifier': This element is not expected. Expected is one of ( {http://oss.dbc.dk/ns/moreinfo}outputType, {http://oss.dbc.dk/ns/moreinfo}callback, {http://oss.dbc.dk/ns/moreinfo}trackingId )"

will be returned.

moreInfoRequest-parameters

Parameter Required 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 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 pipe
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 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 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 pipe
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
externUrl no yes identifierInformation URL to an external site supplied by the owner of the requested record. There are no guarantee that the url is valid nor that there is any content at the specified site, or that the content pointed to is safe to access
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.11/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&pid=870970-basis:29506914

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

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

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

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

Clone this wiki locally
https://github.com/DBCDK/moreinfo/wiki
github.com
CC-MAIN-2024-30
184924
application/http; msgtype=response
sha1:6KPQJX5RV3YCE7KK76WBRBQE6FXLW3CM
<urn:uuid:e1a4db0a-c3ec-4a6b-b609-e9bebbf449b1>
2024-07-18T14:14:20Z
140.82.114.4
text/html
sha1:22PVCOBA2OF7NFWJNW5NSLZ5RTYYQHBV
<urn:uuid:82603603-042f-4887-ad12-77b5baa6cfde>
https://github.com/DBCDK/moreinfo/wiki
response
<urn:uuid:e7df832d-346a-4217-82f8-9ac2781a5b96>
isPartOf: CC-MAIN-2024-30
publisher: Common Crawl
description: Wide crawl of the web for July 2024
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-148
software: Apache Nutch 1.20 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.5-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/