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 will be closed after 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.
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 | 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 | 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 |
externalUrl | 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 multiple PIDS (pidList):
https://moreinfo.addi.dk/2.11/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&pidList=870970-basis:29506914|870970-basis:29506906
Result containing netArchive:
https://moreinfo.addi.dk/2.11/?action=moreInfo&authenticationUser=x&authenticationGroup=x&authenticationPassword=x&pid=870970-basis:52419344