uri-scheme-identifiers.rst
No OneTemporary
Actions

Size

1 KB

Subscribers

None

uri-scheme-identifiers.rst
View Options

	URI scheme for SWH identifiers
	^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

	A subset of Software Heritage objects (contents, directories, releases and revisions)
	can be browsed using :ref:`persistent-identifiers`. Those identifiers
	are guaranteed to remain stable (persistent) over time.

	.. http:get:: /(swh_id)/

	End point to browse SWH objects using their persistent identifiers.
	A redirection to the adequate HTML view will be performed when
	reaching it.

	:param string swh_id: a persistent identifier for a SWH object
	(see the :ref:`persistent-identifiers` section to learn more
	about its syntax)
	:resheader Location: the redirection URL for browsing the SWH object
	associated to the provided identifier
	:statuscode 302: no error
	:statuscode 400: the provided identifier is malformed

	Examples:

	.. parsed-literal::

	:swh_web:`swh:1:cnt:0ffd12d85cdec70c88e852fc3f5ea9fd342213cd`
	:swh_web:`swh:1:dir:db990da9af15427455ce7836ce2b8a34b9bf67f5`
	:swh_web:`swh:1:rel:a9b7e3f1eada90250a6b2ab2ef3e0a846cb16831`
	:swh_web:`swh:1:rev:f1b94134a4b879bc55c3dacdb496690c8ebdc03f`
	:swh_web:`swh:1:snp:673156c31a876c5b99b2fe3e89615529de9a3c44`