SURF created a custom tool called handle reverse lookup to search the handle database to see if the URL is already used and has a PID assigned to it. This can prevent the situation where a URL is assigned to two or more PIDs.

URL with port

The URL must include the correct port supplied by SURF when setting up the service. 

Get credentials for Handle reverse lookup

For this feature a separate username/password is needed.

To get a separate username/password to access this service, send a request through our portal.

Example with curl

Search for a specific URL

curl -u "<username>:<password>" "https://epic-pid.storage.surfsara.nl:<port>/hrls/handles?URL=<URL>"

Note that you can also use wildcard characters:

curl -u "<username>:<password>" "https://epic-pid.storage.surfsara.nl:<port>/hrls/handles?URL=*"

Search for a specific URL and metadata

curl -u "<username>:<password>" "https://epic-pid.storage.surfsara.nl:<port>/hrls/handles?URL=<URL>&EMAIL=<email>"

Limit the number of search results

curl -u "<username>:<password>" "https://epic-pid.storage.surfsara.nl:<port>/hrls/handles?URL=*&limit=<number of results wanted>"

The maximum limit is 100000 and the default is 1000. So by default it will only show 1000 matches when searching.

Search by prefix

curl -u "<username>:<password>" "https://epic-pid.storage.surfsara.nl:<port>/hrls/handles/<prefix>?URL=<URL>"

Retrieve the full Handle records

Set the optional "retrieverecords" parameter to 'true':

curl -u "<username>:<password>" "https://epic-pid.storage.surfsara.nl:<port>/hrls/handles?URL=<URL>&retrieverecords=true"

It will decode the standard strings, but NOT the handle specific records.

Table of contents

  • No labels