Interact with Changes

Added by Steve Luo, edited by Steve Luo on Jun 09, 2011
You are viewing an old version (v. 6) of this page.
The latest version is v. 27, last edited on Jun 13, 2011 (view differences | )
<< View previous version | view page history | view next version >>

Since QuickBuild 4.0, you can retrieve changes via RESTful APIs. The base URI for changes RESTful APIs is:

/rest/changes

List all supported APIs

URI Response Type Params
/rest/changes/help text/html  

Get the data version of changes

URI Response Type Params
/rest/changes/version text/plain  

Get the commit stats

URI Response Type Params
/rest/changes/stats/{configuration_id} application/xml
  • configuration_id
    Id of the configuration.
  • build_id
    The build id you want.
  • from_build
    Specify the from build when finding changes in a build range.
  • to_build
    Specify the to build when finding changes in a build range.
  • from_date
    Specify the from date when finding changes in a build range.
  • to_date
    Specify the to date when finding changes in a build range.
  • date_pattern
    Specify the date pattern when query by a date range, by default, the pattern is yyyyMMdd.
  • repository
    Get the changes only in a specific repository.
  • committer
    Get the changes only committed by the specified committer

Query stats of a specific build

http://quickbuild:8810/changes/stats/25?build_id=102

the response looks like: 

<stats commits="5" modifications="7" added="2" modified="3" deleted="2"/>

or you can add a repository param to retrieve the stats of the specified repository, like:

http://quickbuild:8810/changes/stats/25?build_id=102&repository=mysvn

Query stats for a build range

http://quickbuild:8810/changes/stats/25?from_build=100&to_build=120

Query stats for a date range

http://quickbuild:8810/changes/stats/25?from_date=20110501&to_date=20110601

by default, the date pattern is yyyyMMdd, you can also specify the date pattern by adding parameter date_pattern, the valid date pattern can be found here, for example:

http://quickbuild:8810/changes/stats/25?from_date=2011-05-01&to_date=2011-06-01&date_pattern=yyyy-MM-dd

Retrieve the commits

URI Response Type Params
/rest/changes/{configuration_id} application/xml
  • configuration_id
    The id of configuration.
  • build_id
    The id of a specific build.
  • from_build
    Specify the from build when finding changes in a build range, must be specified with to_build.
  • to_build
    Specify the to build when finding changes in a build range, must be specified with from_build.
  • date_pattern
    Specify the date pattern when query by a date range, by default, the pattern is yyyyMMdd.
  • from_date
    Specify the from date when finding changes in a build range.
  • to_date
    Specify the to date when finding changes in a build range.
  • repository
    Get the changes only in a specific repository.
  • committer
    Get the changes only committed by the specified committer.
  • offset
    Specify the first record when iterate the records.
  • limit
    Specify the number of total records you want to retrieve.
  • asc
    Boolean type, specify the order by commit date ascendent or descendent, by default, it is false.
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.