REST API#
This version of the REST API has been available since version 9.0 of the Laces Data Platform.
Groups#
| Method | Path | Description |
|---|---|---|
| GET | /api/v3/groups |
Return top-level groups |
| POST | /api/v3/groups |
Create new top-level group |
| GET | /api/v3/groups/{id} |
Return group details |
| DELETE | /api/v3/groups/{id} |
Delete group |
| PATCH | /api/v3/groups/{id} |
Update group partially |
| POST | /api/v3/groups/{id} |
Create subgroup within group |
| GET | /api/v3/groups/{id}/subgroups |
Return subgroups of group |
Repositories#
| Method | Path | Description |
|---|---|---|
| GET | /api/v3/groups/{groupId}/repositories |
Return repositories within group |
| GET | /api/v3/repositories |
Return repositories |
| POST | /api/v3/repositories |
Create repository |
| GET | /api/v3/repositories/{id} |
Return repository's details |
| PATCH | /api/v3/repositories/{id} |
Update repository partially |
| DELETE | /api/v3/repositories/{id} |
Delete repository |
Publications#
| Method | Path | Description |
|---|---|---|
| GET | /api/v3/publications.delta |
Delta between versions |
| GET | /api/v3/repositories/{repositoryId}/publications |
Return publications within repository |
| POST | /api/v3/repositories/{repositoryId}/publications |
Create publication |
| GET | /api/v3/publications/{id} |
Return publication's meta-data |
| PATCH | /api/v3/publications/{id} |
Update publication's content and/or meta-data |
| DELETE | /api/v3/publications/{id} |
Delete publication |
| GET | /api/v3/publications/{id}/versions |
Get meta-data of all versions of the publication |
| GET | /api/v3/publications/{id}/statements |
Returns publication's content (RDF) |
| GET | /api/v3/publications/{id}/sparql |
Execute SPARQL query |
| POST | /api/v3/publications/{id}/sparql |
Execute SPARQL query (with POST) |
Note
If you are just 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.
Files#
| Method | Path | Description |
|---|---|---|
| GET | /api/v3/repositories/{repositoryId}/files |
Returns files within repository |
| POST | /api/v3/repositories/{repositoryId}/files |
Create file |
| GET | /api/v3/repositories/{repositoryId}/{filename} |
Return file content |
| GET | /api/v3/repositories/{repositoryId}/{filename}/versions/{version} |
Return versioned file content |
| GET | /api/v3/files/{id} |
Return file metadata |
| GET | /api/v3/files/{id}/content |
Return file content |
| DELETE | /api/v3/files/{id} |
Delete file |
| PUT | /api/v3/files/{id} |
Update file meta-data |
Swagger#
Should you be familiar with Swagger, you can find the Swagger definition of the API in laces-hub-api-v3.json.