Description of the Open Agency service

General description

Open Agency is a web service interface for looking up various parameters for libraries and other service vendors in the VIP-database (https://vip.dbc.dk). These include technical information such as encryption parameters, order policies for use in ORS, Open Search profiles as well as practical information about a library (contact information, opening hours).

Available versions of the service and corresponding WSDL, XSD and sample requests can be found below.

OpenAgency 3.0 is considered the primary production version as per. October 1, 2020.

End-of-life date for versions older than 3.0 is January 1, 2021.

Versions

Version Environment Endpoint WSDL XSD
2.34 production http://openagency.addi.dk/2.34/ http://openagency.addi.dk/2.34/?wsdl http://openagency.addi.dk/2.34/openagency.xsd
2.34 extern test http://openagency.addi.dk/test_2.34/ http://openagency.addi.dk/test_2.34/?wsdl http://openagency.addi.dk/test_2.34/openagency.xsd
2.34 staging http://openagency.addi.dk/next_2.34/ http://openagency.addi.dk/next_2.34/?wsdl http://openagency.addi.dk/next_2.34/openagency.xsd
3.0 production http://openagency.addi.dk/3.0/ http://openagency.addi.dk/3.0/soap?wsdl http://openagency.addi.dk/3.0/soap?xsd=1
3.0 extern test http://openagency.test.addi.dk/3.0/ http://openagency.test.addi.dk/3.0/soap?wsdl http://openagency.test.addi.dk/3.0/soap?xsd=1
3.0 staging http://openagency.stg.addi.dk/3.0/ http://openagency.stg.addi.dk/3.0/soap?wsdl http://openagency.stg.addi.dk/3.0/soap?xsd=1

3.0 and 2.34 differences

Since the introduction of version 3.0 a number of changes has been made.

2.34:

3.0:

Service operations

Automation

This operation provides information about the agencies’ preferences regarding automatic forwarding of end user requests as ill requests to other agencies. This operation is used by the Open Resource Sharing system.

Encryption

Operation for looking up encryption information related to a specific email address, used when sending encrypted emails to an agency. This operation is used by the Open Resource Sharing system.

End User Order Policy

This operation makes it possible to look up whether a specific agency wants to recieve orders from endusers on this type of material. The operation is used by the Open Order sevice.

Find Library

Operation for searching general contact information and alike about a given library

Get CULR Profile

Retrieve information about a library’s CULR-profile

Get Registry Info

Provides contact information, server adresses and ILL-parameters for local registry updates

Get SAOU License Info

Retrieve information on how to to access remote content

Library Rules

Library Type List

Name List

This operation is for receiving a list of agency ids (ISIL numbers) and names of either public libraries (Folkebibliotek) or university and research libraries (Forskningsbibliotek).

Open Search Profile

This operation retrieves information about which data sources are included in a given library’s profile when the searching with Open Search.

Pickup Agency List

This operation can be used for retrieving a list of all public and/or research libraries including contact information, pickup agency information and opening hours.

Remote Access

Using this operation, you can get information about an agency’s subscriptions to licensed resources with remote access.

Request order

This operation retrieves a prioritised list of which agencies materials must be ordered from for a given agency.

Search Collection

Service

The service operation looks up information about a specific agency regarding various services provided by that agency. It can also look up directory information about an agency. The following services are available (most of them are used in ORS):

Show Order

License Terms

The web service is published under the GPLv3 license.