Skip to main content
OCLC Support

Sandbox

Find information about using the Relais Sandbox for testing.

The sandbox is to assist libraries and other vendors who want to test

  • various Relais web services prior to implementing them in production systems, e.g,. a local library catalog or discovery platform. 
  • redirect from a discovery platform to Relais D2D Discovery
  • embed Relais D2D Discovery as part of another discovery platform 

Before using the sandbox.

Review the documentation for the web service that you will be using for more details.  

Contact OCLC Support for a patron id and password (if needed) and an API key.  

Determine which configuration to use based on your local configuration for Relais D2D.  

What to expect when using the sandbox.   

Targets configured

A representative series of catalogs and locations have been configured in the sandbox.  Results from these targets will be retrieved and used.  

  • Aleph
  • Alma
  • Horizon
  • Koha
  • Millennium
  • Ole
  • Polaris
  • Sierra
  • Symphony
  • TLC
  • Voyager
  • WMS

Library symbols/patron ids

A series of library symbols have been configured for testing purposes.  Contact OCLC Support for a patron id (and password if needed) for testing purposes. The appropriate combination to use is dependent on the configuration that you are using

If using Relais D2D for Discovery and

Library symbol

Local catalog configured

Request type assigned

Access to the Discovery UI

Relais D2D for all request management (login prior to accessing Discovery) LIB1 Symphony SB1 https://sandbox.relaisd2d.com/?LS=LIB1&PI=patronid
Relais D2D for all request management (login at time request is submitted) LIB2 Polaris SB2 https://sandbox.relaisd2d.com/?LS=LIB2
ILLiad for all request management LIB3 Ole N/A https://sandbox.relaisd2d.com/?LS=LIB3&PI=patronid
Relais D2D for consortial borrowing request management and ILLiad for ILL processing LIB4 Alma SB4 https://sandbox.relaisd2d.com/?LS=LIB4&PI=patronid

URLs for web services

Web service

Base url

Authentication https://sandbox.relais-host.com/portal-service/user/authentication
DiscoverItem - Search https://sandbox.relaisd2d.com/di/search?aid=${aid}
DiscoverItem - Record https://sandbox.relaisd2d.com/di/search/record?aid=${aid}
Requestability https://sandbox.relais-host.com/dws/item/requestability?aid=${aid}
AddRequest     
https://sandbox.relais-host.com/portal-service/request/add?aid=${aid}
QueryRequest - MyRequests https://sandbox.relais-host.com/portal-service/reuqest/query/my?aid=${aid}