Snapshot#

GET /browse/snapshot/(snapshot_id)/#

HTML view that displays the content of a snapshot from its identifier (see swh.model.git_objects.snapshot_git_object() in our data model module for details about how they are computed).

A snapshot is a set of named branches, which are pointers to objects at any level of the Software Heritage DAG. It represents a full picture of an origin at a given time. Thus, multiple visits of different origins can point to the same snapshot (for instance, when several projects are forks of a common one).

Currently, that endpoint simply performs a redirection to GET /browse/snapshot/(snapshot_id)/directory/ in order to display the root directory associated to the default snapshot branch (usually master).

Parameters:

  • snapshot_id (string) – hexadecimal representation of the snapshot sha1 identifier

Status Codes:

Examples:

https://archive.softwareheritage.org/browse/snapshot/baebc2109e4a2ec22a1129a3859647e191d04df4/
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/

Snapshot directory#

GET /browse/snapshot/(snapshot_id)/directory/#

HTML view that displays the content of a directory reachable from a snapshot.

The features offered by the view are similar to the one for browsing a directory in an origin context (see GET /browse/origin/(origin_url)/directory/[(path)/]).

Parameters:

  • snapshot_id (string) – hexadecimal representation of the snapshot sha1 identifier

Query Parameters:

  • path (string) – optional parameter used to specify the path of a directory reachable from the snapshot root one

  • branch (string) – specify the snapshot branch name from which to retrieve the root directory

  • release (string) – specify the snapshot release name from which to retrieve the root directory

  • revision (string) – specify the snapshot revision, identified by the hexadecimal representation of its sha1_git value, from which to retrieve the root directory

Status Codes:

Examples:

https://archive.softwareheritage.org/browse/snapshot/baebc2109e4a2ec22a1129a3859647e191d04df4/directory/?path=drivers/gpu
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/directory/?path=src/opengl
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/directory/?release=v5.7.0
GET /browse/snapshot/(snapshot_id)/directory/(path)/#

Warning

That endpoint is deprecated, use GET /browse/snapshot/(snapshot_id)/directory/ instead.

HTML view that displays the content of a directory reachable from a snapshot.

The features offered by the view are similar to the one for browsing a directory in an origin context (see GET /browse/origin/(origin_url)/directory/[(path)/]).

param string snapshot_id:

hexadecimal representation of the snapshot sha1 identifier

param string path:

optional parameter used to specify the path of a directory reachable from the snapshot root one

query string branch:

specify the snapshot branch name from which to retrieve the root directory

query string release:

specify the snapshot release name from which to retrieve the root directory

query string revision:

specify the snapshot revision, identified by the hexadecimal representation of its sha1_git value, from which to retrieve the root directory

statuscode 200:

no error

statuscode 400:

an invalid snapshot identifier has been provided

statuscode 404:

requested snapshot cannot be found in the archive

Examples:

https://archive.softwareheritage.org/browse/snapshot/baebc2109e4a2ec22a1129a3859647e191d04df4/directory/drivers/gpu/
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/directory/src/opengl/
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/directory/?release=v5.7.0

Snapshot content#

GET /browse/snapshot/(snapshot_id)/content/#

Warning

That endpoint is deprecated, use GET /browse/content/ instead.

HTML view that produces a display of a content reachable from a snapshot.

The features offered by the view are similar to the one for browsing a content in an origin context (see GET /browse/origin/(origin_url)/content/).

param string snapshot_id:

hexadecimal representation of the snapshot sha1 identifier

query string path:

path of a content reachable from the snapshot root directory

query string branch:

specify the snapshot branch name from which to retrieve the content

query string release:

specify the snapshot release name from which to retrieve the content

query string revision:

specify the snapshot revision, identified by the hexadecimal representation of its sha1_git value, from which to retrieve the content

statuscode 200:

no error

statuscode 400:

an invalid snapshot identifier has been provided

statuscode 404:

requested snapshot cannot be found in the archive, or the provided content path does not exist from the origin root directory

Examples:

https://archive.softwareheritage.org/browse/snapshot/baebc2109e4a2ec22a1129a3859647e191d04df4/content/?path=init/initramfs.c
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/content/?path=src/opengl/qglbuffer.h
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/content/?path=src/opengl/qglbuffer.h&release=v5.0.0
GET /browse/snapshot/(snapshot_id)/content/(path)/#

Warning

That endpoint is deprecated, use GET /browse/content/ instead.

HTML view that produces a display of a content reachable from a snapshot.

The features offered by the view are similar to the one for browsing a content in an origin context (see GET /browse/origin/(origin_url)/content/(path)/).

param string snapshot_id:

hexadecimal representation of the snapshot sha1 identifier

param string path:

path of a content reachable from the snapshot root directory

query string branch:

specify the snapshot branch name from which to retrieve the content

query string release:

specify the snapshot release name from which to retrieve the content

query string revision:

specify the snapshot revision, identified by the hexadecimal representation of its sha1_git value, from which to retrieve the content

statuscode 200:

no error

statuscode 400:

an invalid snapshot identifier has been provided

statuscode 404:

requested snapshot cannot be found in the archive, or the provided content path does not exist from the origin root directory

Examples:

https://archive.softwareheritage.org/browse/snapshot/baebc2109e4a2ec22a1129a3859647e191d04df4/content/init/initramfs.c
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/content/src/opengl/qglbuffer.h/
https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/content/src/opengl/qglbuffer.h/?release=v5.0.0

Snapshot history#

GET /browse/snapshot/log/#

HTML view that produces a display of the revisions history (aka the commit log) for the last collected revision for the given origin. An origin URL must be provided as a query parameter.

Query Parameters:

  • origin_url (string) – specify the origin from which to retrieve the commit log

  • timestamp (string) – optional; an ISO 8601 datetime string to parse in order to find the closest visit

Status Codes:

  • 200 OK – no error

  • 400 Bad Request – origin_url parameter is missing or an invalid snapshot identifier has been provided

  • 404 Not Found – requested origin is either missing or has no associated snapshots

Examples:

https://archive.softwareheritage.org/browse/snapshot/log?origin_url=https://github.com/python/cpython
https://archive.softwareheritage.org/browse/snapshot/log/?origin_url=https://github.com/python/cpython&timestamp=2021-01-23T22:24:10Z
GET /browse/snapshot/(snapshot_id)/log/#

HTML view that produces a display of revisions history (aka the commit log) heading to the last revision collected in a snapshot.

The features offered by the view are similar to the one for browsing the history in an origin context (see GET /browse/origin/(origin_url)/log/).

Parameters:

  • snapshot_id (string) – hexadecimal representation of the snapshot sha1 identifier

Query Parameters:

  • per_page (int) – the number of log entries to display per page (default is 20, max is 50)

  • branch (string) – specify the snapshot branch name from which to retrieve the commit log

  • release (string) – specify the snapshot release name from which to retrieve the commit log

  • revision (string) – specify the snapshot revision, identified by the hexadecimal representation of its sha1_git value, from which to retrieve the commit log

Status Codes:

Examples:

https://archive.softwareheritage.org/browse/snapshot/a274b44111f777209556e94920b7e71cf5c305cd/log/
https://archive.softwareheritage.org/browse/snapshot/9ca9e75279df5f4e3fee19bf5190ed672dcdfb33/log/?branch=refs/heads/emacs-unicode

Snapshot branches#

GET /browse/snapshot/branches/#

HTML view that produces a display of the list of branches collected in a snapshot. An origin URL must be provided as a query parameter.

Query Parameters:

  • origin_url (string) – specify the origin from which to retrieve the snapshot and branches

  • timestamp (string) – optional; an ISO 8601 datetime string to parse in order to find the closest visit

Name_include:

optional; to filter branches by name

Status Codes:

  • 200 OK – no error

  • 400 Bad Request – origin_url parameter is missing or an invalid snapshot identifier has been provided

  • 404 Not Found – requested origin is either missing or has no associated snapshots

Examples:

https://archive.softwareheritage.org/browse/snapshot/branches?origin_url=https://github.com/python/cpython
https://archive.softwareheritage.org/browse/snapshot/branches/?origin_url=https://github.com/python/cpython&timestamp=2021-01-23T22:24:10Z
https://archive.softwareheritage.org/browse/snapshot/branches/?origin_url=https://github.com/python/cpython&name_include=v2
GET /browse/snapshot/(snapshot_id)/branches/#

HTML view that produces a display of the list of branches collected in a snapshot.

The features offered by the view are similar to the one for browsing the list of branches in an origin context (see GET /browse/origin/(origin_url)/branches/).

Parameters:

  • snapshot_id (string) – hexadecimal representation of the snapshot sha1 identifier

Status Codes:

Examples:

https://archive.softwareheritage.org/browse/snapshot/03d7897352541e78ee7b13a580dc836778e8126a/branches/
https://archive.softwareheritage.org/browse/snapshot/f37563b953327f8fd83e39af6ebb929ef85103d5/branches/

Snapshot releases#

GET /browse/snapshot/releases/#

HTML view that produces a display of the list of releases collected in a snapshot. An origin URL must be provided as a query parameter.

Query Parameters:

  • origin_url (string) – specify the origin from which to retrieve the snapshot and branches

  • timestamp (string) – optional; an ISO 8601 datetime string to parse in order to find the closest visit

Name_include:

optional; to filter releases by name

Status Codes:

  • 200 OK – no error

  • 400 Bad Request – origin_url parameter is missing or an invalid snapshot identifier has been provided

  • 404 Not Found – requested origin is either missing or has no associated snapshots

Examples:

https://archive.softwareheritage.org/browse/snapshot/releases?origin_url=https://github.com/python/cpython
https://archive.softwareheritage.org/browse/snapshot/releases/?origin_url=https://github.com/python/cpython&timestamp=2021-01-23T22:24:10Z
https://archive.softwareheritage.org/browse/snapshot/releases/?origin_url=https://github.com/python/cpython&name_include=v2
GET /browse/snapshot/(snapshot_id)/releases/#

HTML view that produces a display of the list of releases collected in a snapshot.

The features offered by the view are similar to the one for browsing the list of releases in an origin context (see GET /browse/origin/(origin_url)/releases/).

Parameters:

  • snapshot_id (string) – hexadecimal representation of the snapshot sha1 identifier

Status Codes:

Examples:

https://archive.softwareheritage.org/browse/snapshot/673156c31a876c5b99b2fe3e89615529de9a3c44/releases/
https://archive.softwareheritage.org/browse/snapshot/23e6fb084a60cc909b9e222d80d89fdb98756dee/releases/