Obtaining Project Commits

Function

This API is used to obtain the latest ten project commits.

URI

GET /v1/{project_id}/git/repos/{namespace}/{project}/commits

Table 1 describes the parameters.

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Tenant's project ID. See Obtaining a Project ID.
namespace	Yes	String	Namespace ID or URL code name. See Obtaining a Repository Namespace.
project	Yes	String	Repository project ID or URL code name. If the value contains a slash (/), replace it with a colon (:). See Obtaining All Projects in a Namespace.

**Table 2** Query parameters
Parameter	Mandatory	Type	Description
ref	No	String	Branch or tag name. If it is not provided, use the default branch.

Request

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Message body type (format). Default value: application/json;charset=utf8.
X-Auth-Token	Yes	String	API calling can be authenticated using a token or AK/SK. If you use a token, this parameter is mandatory and must be set to the token. For details about how to obtain a token, see Obtaining a User Token.
X-Repo-Auth	Yes	String	Authorization name. See Obtaining a Git Repository Authorization List.

Response

**Table 4** Response parameter
Parameter	Type	Description
commits	Array<Object>	Project commits structure. See Table 5.

**Table 5** commits
Parameter	Type	Description
sha	String	Commit SHA value.
message	String	Commit description.
authored_date	String	Import time.

Example Request

None

Example Response

{
  "commits": [
    {
      "sha": "6dcb09b5b57875f334f61aebed695e2e4193db5e",
      "message": "Fix all the bugs",
      "authored_date": "Fix all the bugs"
    }
  ]
}