Webhob REST API Builds: Difference between revisions

From Yocto Project
Jump to navigationJump to search
No edit summary
No edit summary
 
(20 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Category:REST API Contracts]]
Superceded by [[REST API Contracts]]
 
=== Endpoints ===
 
{| class="wikitable"
|-
! Method !! Endpoint !! Body !! Description !! Comments
|-
| GET || /builds || JSON || Returns page size limited and search criteria filtered amount of builds from the data base || -
|}
 
=== Parameters ===
 
{| class="wikitable"
|-
! Name !! Type !! Description !! Comments
|-
| limit || number || The amout of builds to be displayed in one page ||  -
|-
| offset || number || Represents the position of the first record in the page  ||  If limit is 1, end point will target the findOne functionality and the offset will act as the actual build id
|-
| filter || string || Consists of a string used to filter results || Generic parameter sent from front-end application.
|}
 
=== Response ===
 
{| class="wikitable"
|-
! Name !! Type !! Dimension !! Required !! Default value(s) !! Description !! Comments
|-
| [Object Root] || object || - || YES || - || The object root (will not be literaly be used in the coding).<br />Used only here to describe the container for the actual properties. || -
|-
| [Object Root].<span style="color:#006600">count</span> || number || - || YES || - || Total amount of builds || -
|-
| [Object Root].<span style="color:#006600">list</span> || object(Build DTO) array || - || YES || - || The list of Build DTOs within the given limit || Reffer to Build DTO for object description
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">outcome</span> || number || 2 || YES || - || Signals successful or failed build || 0 - the build has failed,<br /> 1 - successful build
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">target</span> || string || - || YES || - || The name of the build target(s) || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">machine</span> || string array || - || YES || - || The selected hardware || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">startedOn</span> || number representation of date || - || YES || - ||  Marks the moment the process is started || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">completedOn</span> || number representation of date || - || YES || - || Marks the moment the process is completed || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">errors</span> || number || - || YES || - || Number of errors thrown by the build || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">warnings</span> || number || - || YES || - || Number of warnings thrown by the build || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">log</span> || string || - || YES || - || Path to log file || -
|-
| [Object Root].<span style="color:#FF9900">list[]</span>.<span style="color:#006600">output</span> || string array || - || YES || - || The extensions of the root file systems produced by the build || -
|}

Latest revision as of 16:28, 14 August 2013

Superceded by REST API Contracts