Webhob REST API Builds: Difference between revisions

From Yocto Project
Jump to navigationJump to search
No edit summary
No edit summary
Line 43: Line 43:
| [Object Root].<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:#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:#006600">target</span> || string || - || YES || - || - || -
| [Object Root].<span style="color:#006600">target</span> || string || - || YES || - || The name of the build target(s || -
|-
|-
| [Object Root].<span style="color:#006600">machine</span> || string array || - || YES || - || - || -
| [Object Root].<span style="color:#006600">machine</span> || string array || - || YES || - || The selected hardware || -
|-
|-
| [Object Root].<span style="color:#006600">startedOn</span> || number representation of date || - || YES || - ||  Marks the moment the process is started || -
| [Object Root].<span style="color:#006600">startedOn</span> || number representation of date || - || YES || - ||  Marks the moment the process is started || -
Line 51: Line 51:
| [Object Root].<span style="color:#006600">completedOn</span> || number representation of date || - || YES || - || Marks the moment the process is completed || -
| [Object Root].<span style="color:#006600">completedOn</span> || number representation of date || - || YES || - || Marks the moment the process is completed || -
|-
|-
| [Object Root].<span style="color:#006600">errors</span> || number || - || YES || - || Number of errors || -
| [Object Root].<span style="color:#006600">errors</span> || number || - || YES || - || Number of errors thrown by the build || -
|-
|-
| [Object Root].<span style="color:#006600">warnings</span> || number || - || YES || - || Number of warnings || -
| [Object Root].<span style="color:#006600">warnings</span> || number || - || YES || - || Number of warnings thrown by the build || -
|-
|-
| [Object Root].<span style="color:#006600">log</span> || string || - || YES || - || Path to log file || -
| [Object Root].<span style="color:#006600">log</span> || string || - || YES || - || Path to log file || -
|-
|-
| [Object Root].<span style="color:#006600">output</span> || string array || - || YES || - || Output package types || -
| [Object Root].<span style="color:#006600">output</span> || string array || - || YES || - || The extensions of the root file systems produced by the build || -
|}
|}

Revision as of 09:46, 19 July 2013


Endpoints

Nr. Method Endpoint Body Description Comments
1 GET /builds JSON Returns page size limited and search criteria filtered amount of builds from the data base -
2 GET /builds_count JSON Returns the total amount of builds from the data base -
3 GET /builds/{id} JSON Returns single build from the data base according to it's id -

Parameters

Affected Endpoint Name Type Description Comments
1 limit number The amout of builds to be displayed in one page -
1 offset number Represents the position of the first record in the page -
1 filter string Consists of a string used to filter results -
3 id number Path parameter that passes the build id -

Responses

Endpoint 1 ( /builds )

The information retrieved from this endpoint is actualy a list of same tructure objects. The following table describes a generic element of the list.

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). Used only here to describe the container for the actual properties. -
[Object Root].outcome number 2 YES - Signals successful or failed build 0 - the build has failed,
1 - successful build
[Object Root].target string - YES - The name of the build target(s -
[Object Root].machine string array - YES - The selected hardware -
[Object Root].startedOn number representation of date - YES - Marks the moment the process is started -
[Object Root].completedOn number representation of date - YES - Marks the moment the process is completed -
[Object Root].errors number - YES - Number of errors thrown by the build -
[Object Root].warnings number - YES - Number of warnings thrown by the build -
[Object Root].log string - YES - Path to log file -
[Object Root].output string array - YES - The extensions of the root file systems produced by the build -