Help Page Home - Items
POST Item/id/build
Build a quantity of a combo item.
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| WsAccessKey | The Web Service access key for this user and file which allows access to the API for the associated file (found in File - Settings). Using OAuth authentication mechanism is the preferred method to allow API access. | string |
Optional. Legacy authentication method and only required if not using OAuth. OAuth is preferred. |
| FileId | Specifies the file id of the file to perform the operation upon. | integer |
Required |
| id | Item Id | integer |
Required |
Body Parameters
Build details.
BuildComboItem| Name | Description | Type | Additional information |
|---|---|---|---|
| Quantity | The quantity to build. | decimal number |
None. |
Request Formats
application/json, text/json
Sample:
{
"Quantity": 1.0
}
application/xml, text/xml
Sample:
<BuildComboItem xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Quantity>1</Quantity> </BuildComboItem>
Response Information
Resource Description
BuildItemResult| Name | Description | Type | Additional information |
|---|---|---|---|
| ItemId | The id of the built item. | integer |
None. |
| StatusMessage | Status message from the response (if any). | string |
None. |
| _links | Hypermedia links. Contains contextual links to possible next actions related to this resource. Only present in responses. This data is not to be sent to the server. | Collection of Link |
None. |
Response Formats
application/json, text/json
Sample:
{
"ItemId": 123,
"StatusMessage": "1 combo item(s) have been built.",
"_links": [
{
"rel": "detail",
"href": "https://api.saasu.com/Item/123?FileId=1234",
"method": "GET",
"title": null
},
{
"rel": "self",
"href": "https://api.saasu.com/Item/123/build/?FileId=1234",
"method": "GET",
"title": null
}
]
}
application/xml, text/xml
Sample:
<BuildItemResult xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<_links>
<Link>
<rel>detail</rel>
<href>https://api.saasu.com/Item/123?FileId=1234</href>
<method>GET</method>
</Link>
<Link>
<rel>self</rel>
<href>https://api.saasu.com/Item/123/build/?FileId=1234</href>
<method>GET</method>
</Link>
</_links>
<StatusMessage>1 combo item(s) have been built.</StatusMessage>
<ItemId>123</ItemId>
</BuildItemResult>