RestContract icon indicating copy to clipboard operation
RestContract copied to clipboard

Documentation needed for endpoint `api/pid/find`

Open bruno-atmire opened this issue 3 years ago • 2 comments

Issue

Given a handle, I wanted to query the REST API to access the matching DSpace Object. I searched through the REST contract, but could not find any mention of a REST endpoint to resolve a handle.

After consulting with my colleagues and digging through the Angular code, we found the following endpoint: https://api7.dspace.org/server/#/server/api/pid/find?id=hdl:10673/403

This endpoint does not seem to be documented. Can this be added?

Background info

The /api/pid/find endpoint routes to IdentifierRestController, which calls the IdentifierService, which supports multiple IdentifierProviders. Supported identifier providers include: DOIIdentifierProvider, EZIDIdentifierProvider, HandleIdentifierProvider, etc.

bruno-atmire avatar Apr 14 '22 10:04 bruno-atmire

Agreed, this documentation is currently lacking. PRs/volunteers welcome!

tdonohue avatar May 09 '22 16:05 tdonohue

Documentation for /server/api/dso/find is also missing. Adding a comment here because I just stumbled upon it and it seems related.

alanorth avatar May 13 '24 13:05 alanorth