Description

Get a list of all revisions heading to a given one, in other words show the commit log.

The revisions are returned in the breadth-first search order while visiting the revision graph. The number of revisions to return is also bounded by the limit query parameter.

Request

GET https://archive.softwareheritage.org/api/1/revision/e7bcb30ab974aefa306194bedc2d4f5dd0a83afa/log/

Response

Body
[
    {
        "author": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer_date": "2023-09-28T20:28:45+00:00",
        "date": "2023-09-28T20:28:45+00:00",
        "directory": "cbbfebff33431158480a3984535f37fe5a748dfd",
        "directory_url": "https://archive.softwareheritage.org/api/1/directory/cbbfebff33431158480a3984535f37fe5a748dfd/",
        "extra_headers": [],
        "history_url": "https://archive.softwareheritage.org/api/1/revision/e7bcb30ab974aefa306194bedc2d4f5dd0a83afa/log/",
        "id": "e7bcb30ab974aefa306194bedc2d4f5dd0a83afa",
        "merge": false,
        "message": "0.4\n",
        "metadata": {},
        "parents": [
            {
                "id": "2629ae3918722c2c3215217905a536d5db26c666",
                "url": "https://archive.softwareheritage.org/api/1/revision/2629ae3918722c2c3215217905a536d5db26c666/"
            }
        ],
        "synthetic": false,
        "type": "git",
        "url": "https://archive.softwareheritage.org/api/1/revision/e7bcb30ab974aefa306194bedc2d4f5dd0a83afa/"
    },
    {
        "author": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer_date": "2023-08-25T17:53:48+00:00",
        "date": "2023-08-25T17:53:48+00:00",
        "directory": "81ff26bfcbcd2bc4e61ccb86a54773bd33304a80",
        "directory_url": "https://archive.softwareheritage.org/api/1/directory/81ff26bfcbcd2bc4e61ccb86a54773bd33304a80/",
        "extra_headers": [
            [
                "gpgsig",
                "-----BEGIN PGP SIGNATURE-----\n\niQEzBAABCAAdFiEEsh1f45drUp44iGlLQzUkdRtx1IoFAmTo6qwACgkQQzUkdRtx\n1IrJYgf+K9KD/61jgymJIY1MyZsU+Wexj1G5y84uaKWeIOVtnp27y4rZqU6ZI9k3\nGEzBEpiZsuiyBEwkQpa221mryItolmOcaVuvCLECzBU4jogz4pcJMMlVWtyDoIHB\ncar3Yx8ehExjbXw8ml2k7ub9HBZHPvhiut5ShwtkG/uoUEzg0IbPJ7jGeAZEuZat\nDMboltC5jgALdioQwXelVdQo67sAU9/c04RtyUkAVEKzucLfLuayARfKfQdDxWls\nE1lXTAL7cvz0qPjnrs1DvMYMEKTwMh+JHK91PgM9rGUOhcFB54+MSDX+AoEk9XIe\nzlnnDDcpE2hB81/ccOCtCKGkiE2orQ==\n=MGWd\n-----END PGP SIGNATURE-----"
            ]
        ],
        "history_url": "https://archive.softwareheritage.org/api/1/revision/2629ae3918722c2c3215217905a536d5db26c666/log/",
        "id": "2629ae3918722c2c3215217905a536d5db26c666",
        "merge": false,
        "message": "0.3\n",
        "metadata": {},
        "parents": [
            {
                "id": "e6cbafc0e70cf88900619dd9f4ebebef76513bd0",
                "url": "https://archive.softwareheritage.org/api/1/revision/e6cbafc0e70cf88900619dd9f4ebebef76513bd0/"
            }
        ],
        "synthetic": false,
        "type": "git",
        "url": "https://archive.softwareheritage.org/api/1/revision/2629ae3918722c2c3215217905a536d5db26c666/"
    },
    {
        "author": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer_date": "2022-09-10T11:32:59-04:00",
        "date": "2022-09-10T11:32:59-04:00",
        "directory": "8808502dec79b29d3759a41ea425ec273484b1d4",
        "directory_url": "https://archive.softwareheritage.org/api/1/directory/8808502dec79b29d3759a41ea425ec273484b1d4/",
        "extra_headers": [
            [
                "gpgsig",
                "-----BEGIN PGP SIGNATURE-----\n\niQEzBAABCAAdFiEEsh1f45drUp44iGlLQzUkdRtx1IoFAmMcrisACgkQQzUkdRtx\n1IqpfAgAinE6aOlR3MUPb8o8DQIxFmXA6EWiUT2hqcVAfDyyalyJk6PYd0DjOE1X\n9K1+gXvZTYGX4/42Uf05xrRUG98pcb2/S/w7cssDDv0+EJ+AWU8u1h0ynglHMTzK\nfmE9n16W6NTZTzR6AF3xJWfHSXK8nbL3GatrOjpNQDl494Swffdqp/LJg7MzoT3f\nmCrX5+FLf3YgZeZ10ZgkpaSbsXrjGzQV6qS3T06or9VUjp1h+Yyv0hRWEzcGLeP1\nswLyMpOIKrvM6EjRMbpMW9G9zWY7b8IoDu44WNGJpe3JyDThbnIUZv/ImnLv7D2y\nAZZUYq1lWY3oepkAajAMhSrKcMV73A==\n=Z2G4\n-----END PGP SIGNATURE-----"
            ]
        ],
        "history_url": "https://archive.softwareheritage.org/api/1/revision/e6cbafc0e70cf88900619dd9f4ebebef76513bd0/log/",
        "id": "e6cbafc0e70cf88900619dd9f4ebebef76513bd0",
        "merge": false,
        "message": "0.2\n",
        "metadata": {},
        "parents": [
            {
                "id": "0672acc7e2dbd55bfaf3e71bf36babea8cc14666",
                "url": "https://archive.softwareheritage.org/api/1/revision/0672acc7e2dbd55bfaf3e71bf36babea8cc14666/"
            }
        ],
        "synthetic": false,
        "type": "git",
        "url": "https://archive.softwareheritage.org/api/1/revision/e6cbafc0e70cf88900619dd9f4ebebef76513bd0/"
    },
    {
        "author": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer_date": "2022-09-09T20:43:45-04:00",
        "date": "2022-09-09T20:43:45-04:00",
        "directory": "353e7c60facfb56655b440b225f369657a21cefb",
        "directory_url": "https://archive.softwareheritage.org/api/1/directory/353e7c60facfb56655b440b225f369657a21cefb/",
        "extra_headers": [
            [
                "gpgsig",
                "-----BEGIN PGP SIGNATURE-----\n\niQEzBAABCAAdFiEEsh1f45drUp44iGlLQzUkdRtx1IoFAmMb3cEACgkQQzUkdRtx\n1Io7YAf/Q5darOy8YCs7EX7Z/Jxqdrm0qw39zcyda4Y3L/4ZkrfkYwJych6dTkeL\nUaYLpJQT8mA88O96epsIUPGFmIbLwCeS36JBBrnNbgWLxZFJ7RwRBP9kue3tqfRI\nmOlrt9NfJrXUKCdauLKszmGKN20vzvulyj1HL+z58b4wVf99Uumq6IUDuAzaUXIY\n04ilOdJthQbfCX/TW/oIVrnDv262ZPhTguICBpOj6cIIVK0sL+TapDRdAWHrWsxo\nAy/NK7JkuYxeL6xMF8aAeAjo7JQ8Gk0MfFixDbTeSXxUTLYvwRbxFdEnLgsPFGMh\nX3fkMCVmOwGGapepXOeXBG8R41faTg==\n=zanp\n-----END PGP SIGNATURE-----"
            ]
        ],
        "history_url": "https://archive.softwareheritage.org/api/1/revision/0672acc7e2dbd55bfaf3e71bf36babea8cc14666/log/",
        "id": "0672acc7e2dbd55bfaf3e71bf36babea8cc14666",
        "merge": false,
        "message": "0.1\n",
        "metadata": {},
        "parents": [
            {
                "id": "73376ff0fc89285ecb9de4e76954faa6000aca1f",
                "url": "https://archive.softwareheritage.org/api/1/revision/73376ff0fc89285ecb9de4e76954faa6000aca1f/"
            }
        ],
        "synthetic": false,
        "type": "git",
        "url": "https://archive.softwareheritage.org/api/1/revision/0672acc7e2dbd55bfaf3e71bf36babea8cc14666/"
    },
    {
        "author": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer": {
            "email": "castedo@castedo.com",
            "fullname": "Castedo Ellerman <castedo@castedo.com>",
            "name": "Castedo Ellerman"
        },
        "committer_date": "2022-09-09T10:33:57-04:00",
        "date": "2022-09-09T10:33:57-04:00",
        "directory": "4b825dc642cb6eb9a060e54bf8d69288fbee4904",
        "directory_url": "https://archive.softwareheritage.org/api/1/directory/4b825dc642cb6eb9a060e54bf8d69288fbee4904/",
        "extra_headers": [
            [
                "gpgsig",
                "-----BEGIN PGP SIGNATURE-----\n\niQEzBAABCAAdFiEEsh1f45drUp44iGlLQzUkdRtx1IoFAmMbTtUACgkQQzUkdRtx\n1Ir2Rgf9HRapYU3iWEP/UBu7/DqAnwqe4+ANqE2W+tSL4KsnioGKMOVsI2HXq7kT\niRE3m5TuqsL6rw3sihAS7B5Z5rQ5TJgWy+K5xhtkfeIiFZ1RyfTEUKN7dhGCcyp9\nwvP/BNrxHFadtEo/teyRr2pjmHfabB2LYp5tFtVr0sowGBCDL/7KLeImf/CCFCxW\n0Ac6MdhYugbBI9ly9WrpqRteny5+WX6+2V3RokYa9T5aYVwWxlA30uUgp+jIFnaY\nxX+lMM4XtB+JrKwBhyqqey/88G8guZow9yuFFovOSW9xQ24oKl0xPUPbqVf5YP4Y\nUGImp1SG3pjnwcSz4S4UTObaoj2IrQ==\n=1nAq\n-----END PGP SIGNATURE-----"
            ]
        ],
        "history_url": "https://archive.softwareheritage.org/api/1/revision/73376ff0fc89285ecb9de4e76954faa6000aca1f/log/",
        "id": "73376ff0fc89285ecb9de4e76954faa6000aca1f",
        "merge": false,
        "message": "castedo.com/doc/156\n",
        "metadata": {},
        "parents": [],
        "synthetic": false,
        "type": "git",
        "url": "https://archive.softwareheritage.org/api/1/revision/73376ff0fc89285ecb9de4e76954faa6000aca1f/"
    }
]

URL Allowed Methods

https://archive.softwareheritage.org/api/1/revision/ (sha1_git) /log/

GET, HEAD, OPTIONS

Arguments

sha1_git (string)

hexadecimal representation of the revision sha1_git identifier


Query parameters

limit (int)

maximum number of revisions to return when performing BFS traversal on the revision graph (default to 10, cannot exceed 1000)


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


Returns

array

an array of objects containing the following keys:

  • author (object): information about the author of the revision

  • committer (object): information about the committer of the revision

  • committer_date (string): RFC3339 representation of the commit date

  • date (string): RFC3339 representation of the revision date

  • directory (string): the unique identifier that revision points to

  • directory_url (string): link to /api/1/directory/ to get information about the directory associated to the revision

  • id (string): the revision unique identifier

  • merge (boolean): whether or not the revision corresponds to a merge commit

  • message (string): the message associated to the revision

  • parents (array): the parents of the revision, i.e. the previous revisions that head directly to it, each entry of that array contains an unique parent revision identifier but also a link to /api/1/revision/ to get more information about it

  • type (string): the type of the revision


HTTP status codes

200

no error

400

an invalid sha1_git value has been provided

404

head revision cannot be found in the archive


Examples

/api/1/revision/e1a315fa3fa734e2a6154ed7b5b9ae0eb8987aad/log/
back to top