API - List PID

This API uses JSON as the primary exchange format. All implementations MUST be able to produce and consume JSON.

List PID - Description

You can retrieve the list of pids at once, by just supplying the Service Url with the prefix.

DescriptionGET a PID
URLThe API Service URL
SecurityYou must authenticate before actually getting all PID.

Because collections can get very lange, they are rendered page by page. By default, you'll only see the first page with at maximum 1000 results. To modify this behaviour, use the following query parameters:

ParameterValueDescriptionExample value
limitint: the limit of resultsthe maximum number of items to return. The default is 1000. As a special case, if you specify limit=0, all items will be returned, without limit.https://epic.grnet.gr/api/v2/handles/11239/?limit=10
pageint: the page of resultsWhen using limit parameter the returned data are displayed on multiple pages. the number of the page to return. I.e., if you specify limit=100&page=3, items 201 through 300 will be returnedhttps://epic.grnet.gr/api/v2/handles/11239/?limit=10&page=2


In this example we are going to retrieve the information of all PID in the 11239 prefix URL https://epic.grnet.gr/api/v2/handles/11239/

The request in curl

curl -D- -u "YOURUSERNAME:YOURPASSWORD" -X GET -H "Content-Type: application/json" https://epic.grnet.gr/api/v2/handles/11239/

The response:

  • HTTP/1.1 200 OK: (Success)
  • HTTP/1.1 401 Unauthorized: Your username or your password is wrong
  • HTTP/1.1 404 NOT found: The url doesn't exist

After a successful request, the response consists of a list of PIDs