REST API#
This version of the REST API has been available since version 7.0 of the Laces Hub.
WARNING: Please note that services below are outdated and might become deprecated in the future, refer to version v2 for a list of all latest services!
Groups#
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/groups |
Return top-level groups |
| POST | /api/v1/groups |
Create new top-level group |
| GET | /api/v1/groups/{groupId} |
Return group details |
| DELETE | /api/v1/groups/{groupId} |
Delete group |
| PATCH | /api/v1/groups/{groupId} |
Update group partially |
| POST | /api/v1/groups/{groupId} |
Create subgroup within group |
| GET | /api/v1/groups/{groupId}/subgroups |
Return subgroups of group |
Repositories#
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/respositories |
Return repositories |
| POST | /api/v1/respositories |
Create repository |
| GET | /api/v1/respositories/{repositoryId} |
Return repository's details |
| DELETE | /api/v1/respositories/{repositoryId} |
Delete repository |
| GET | /api/v1/respositories/{groupId}/repositories |
Return repositories within group |
Publications#
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/respositories/{repositoryId}/publications |
Return publications within repository |
| POST | /api/v1/respositories/{repositoryId}/publications |
Create publication |
| PUT | /api/v1/respositories/{repositoryId}/publications |
Update publication |
| GET | /api/v1/repositories/{repositoryId}/publications/publication |
Return publication |
| DELETE | /api/v1/repositories/{repositoryId}/publications/publication |
Delete publications |
| GET | /api/v1/repositories/{repositoryId}/publications/{accessibility}/{status}/{context}/{function}/{name} |
Return publication's meta-data |
| PATCH | /api/v1/repositories/{repositoryId}/publications/{accessibility}/{status}/{context}/{function}/{name} |
Update publication's meta-data |
| GET | /api/v1/repositories/{repositoryId}/publications/{accessibility}/{status}/{context}/{function}/{name}/sparql |
Execute SPARQL query |
| GET | /api/v1/repositories/{repositoryId}/publications/{accessibility}/{status}/{context}/{function}/{name}/{version} |
Return publication's meta-data |
| PATCH | /api/v1/repositories/{repositoryId}/publications/{accessibility}/{status}/{context}/{function}/{name}/{version} |
|
| GET | /api/v1/repositories/{repositoryId}/publications/{accessibility}/{status}/{context}/{function}/{name}/{version}/sparql |
Execute SPARQL query |
| GET | /api/v1/publications.delta |
Delta between versions |
Note: for publications (prior to v2 API) we expect all publications to have a fixed number of segments {accessibility}/{status}/{context}/{function}/{name}. From version v2 onwards this is no longer the case. Please only use the aforementioned URLs in case you published with these 5 segments in place; otherwise refer to the documention in version 2.
Note 2: should you just be interested in retrieving the RDF data or executing a SPARQL query on a publication, you can also directly use the publication's URL for this; for more info check out the REST API Basics.
Swagger#
Should you be familiar with Swagger, you can find the Swagger definition of the API in laces-hub-api-v1.json.