Assets API
Introduction
This set of endpoints is for interacting with assets directly.
Endpoints
List Assets
GET /service/rest/v1/assets
This endpoint allows us to iterate through a listing of assets contained in a given repository.
Let's get a listing of the assets in the maven-central
repository:
curl -u admin:admin123 -X GET 'http://localhost:8081/service/rest/v1/assets?repository=maven-central'
This produces a response that is the first pages of many assets in that repository:
{ "items" : [ { "downloadUrl" : "http://localhost:8081/repository/maven-central/asm/asm/3.1/asm-3.1-sources.jar", "path" : "asm/asm/3.1/asm-3.1-sources.jar", "id" : "bWF2ZW4tY2VudHJhbDozZjVjYWUwMTc2MDIzM2I2MTRkZWJlOTExOGFjNjMwOQ", "repository" : "maven-central", "format" : "maven2", "checksum" : { "sha1" : "2eaa4de56203f433f287a6df5885ef9ad3c5bcae", "md5" : "0c0e3e83d9ce7907334c5eb519dab10c" } }, ... ], "continuationToken" : "3f5cae01760233b6506547dc7be10e0b" }
This endpoint uses a pagination strategy that can be used to iterate through all the assets if desired.
Note that the ordering of assets is consistent across multiple queries and is not alphabetical.
Get Asset
GET /service/rest/v1/assets/{id}
This endpoint allows us to get the details of an individual asset.
curl -u admin:admin123 -X GET 'http://localhost:8081/service/rest/v1/assets/bWF2ZW4tY2VudHJhbDozZjVjYWUwMTc2MDIzM2I2MjRiOTEwMmMwMmNiYmU4YQ'
{ "blobCreated": "2018-08-25T15:00:50.408+00:00", "checksum": { "md5": "734c1c5f44166e088d100accdb4b1474", "sha1": "7b6e93e5e6403323cd70a18829a33f6cb4c0388d" }, "contentType": "application/java-archive", "downloadUrl": "http://localhost:8081/repository/maven-central/org/apache/maven/plugins/maven-source-plugin/2.2.1/maven-source-plugin-2.2.1.jar", "format": "maven2", "id": "bWF2ZW4tY2VudHJhbDpjNzU0NTU3OWE3YTE1MzkwYTZjYTEyZGI5MDAxMWI2OQ", "lastDownloaded": "2018-08-25T15:00:50.412+00:00", "lastModified": "2018-08-25T15:00:50.408+00:00", "maven2": { "artifactId": "maven-source-plugin", "extension": "jar", "groupId": "org.apache.maven.plugins", "version": "2.2.1" }, "path": "org/apache/maven/plugins/maven-source-plugin/2.2.1/maven-source-plugin-2.2.1.jar", "repository": "maven-central" }
Delete Asset
DELETE /service/rest/v1/assets/{id}
This endpoint can be used to delete an individual asset.
curl -u admin:admin123 -X DELETE 'http://localhost:8081/service/rest/v1/assets/bWF2ZW4tY2VudHJhbDozZjVjYWUwMTc2MDIzM2I2MjRiOTEwMmMwMmNiYmU4YQ'
A successful deletion will return no content, for example:
HTTP/1.1 204 No Content Date: Fri, 19 Jan 2018 20:41:47 GMT ...