EPIC API v2

Test account

• Server: ​http://pid-vm04.gwdg.de:8080/
• User name: clarintest1
• Password: xrl#4xbE
• Prefix: ​11148

Production environment

Prefix 11372

• Service endpoint: ​http://pid.gwdg.de/handles/11372
• Accounts
  • clarin1 (password known by Twan?), to be used by the VCR
  • ... (credentials known by Jozef?)

Prefix 11459

• Service endpoint: ​http://pid.gwdg.de/handles/11459
• Accounts
  • clarin2-* (passwords known by Menzo?, used by the OpenSKOS-based concept registry

GWDG contact

GWDG, Handle <​handle@gwdg.de>

Documentation

• ​Technical documentation + API specification

Usage examples

Taken from ​http://epic.gwdg.de/wiki/index.php/EPIC:API:v2:contribution:

The current PID-Service requires HTTP BASIC AUTH authentication, use the -u parameter.

A) In order to get a JSON response specify application/json in the "Accept" header field:

curl  -vv -u "user:pass" -H "Content-Type:application/json"  -H "Accept:application/json" -X POST --data '[{"type":"URL","parsed_data":"http://www.gwdg.de"}]' http://pid.gwdg.de/handles/$PREFIX

B) In order to get a HTML response specify text/html in the "Accept" header field:

curl  -vv -u "user:pass" -H "Content-Type:application/json"  -H "Accept:text/html" -X POST --data '[{"type":"URL","parsed_data":"http://www.gwdg.de"}]' http://pid.gwdg.de/handles/$PREFIX

C) In order to get a XHTML response specify application/xhtml+xml in the "Accept" header field:

curl  -vv -u "user:pass" -H "Content-Type:application/json"  -H “Accept:application/xhtml+xml" -X POST --data '[{"type":"URL","parsed_data":"http://www.gwdg.de"}]' http://pid.gwdg.de/handles/$PREFIX

VIEW

• VIEW the PID 11022/1234-5678-1234-C in HTML format:

  curl -u 'tkalman:MyPaSsWoRd' http://pid.gwdg.de/handles/11022/1234-5678-1234-C
  

• VIEW the PID 11022/1234-5678-1234-C in JSON format (Accept: header):

  curl -u 'tkalman:MyPaSsWoRd' -H "Accept:application/json" http://pid.gwdg.de/handles/11022/1234-5678-1234-C
  

(Note the Accept:application/json header.)

CREATE

• Creating a PID for the URL "​http://www.gwdg.de/TEST/abcdef":

  curl -u 'tkalman:MyPaSsWoRd' -H "Accept:application/json" -H "Content-Type:application/json" '''-X POST''' --data ''''[{"type":"URL","parsed_data":"http://www.gwdg.de/TEST/abcdef"}]'''' http://pid.gwdg.de/handles/11022/
  

UPDATE

• Updating the PID 11022/1234-5678-1234-C:

Use the PUT method to update the Handle 11022/1234-5678-1234-C:

curl -u 'tkalman:MyPaSsWoRd' -H "Accept:application/json" -H "Content-Type:application/json" -X '''PUT''' --data '[{"type":"URL","parsed_data":"http://www.gwdg.de/TEST/newurl"}]' http://pid.gwdg.de/handles/'''11022/1234-5678-1234-C''