swh.web.api.views.release module#

swh.web.api.views.release.api_release(request: Request, sha1_git: str)[source]#

GET /api/1/release/(sha1_git)/#

Get information about a release in the archive. Releases are identified by sha1 checksums, compatible with Git tag identifiers. See swh.model.git_objects.release_git_object() in our data model module for details about how they are computed.

Parameters:

sha1_git (string) – hexadecimal representation of the release sha1_git identifier

Request Headers:

Accept – the requested response content type, either application/json (default) or application/yaml

Response Headers:

Content-Type – this depends on Accept header of request

Response JSON Object:

author (object) – information about the author of the release
date (string) – RFC3339 representation of the release date
id (string) – the release unique identifier
message (string) – the message associated to the release
name (string) – the name of the release
target (string) – the target identifier of the release
target_type (string) – the type of the target, can be either release, revision, content, directory
target_url (string) – a link to the adequate api url based on the target type

Status Codes:

200 OK – no error
400 Bad Request – an invalid sha1_git value has been provided
404 Not Found – requested release cannot be found in the archive

Example:

https://archive.softwareheritage.org/api/1/release/208f61cc7a5dbc9879ae6e5c2f95891e270f09ef/

swh.web.api.views.release module#

This Page