Mauve.Bestellforum

<back to all web services

GetItem

Get an item by its number.

Requires Authentication
Requires any of the permissions:all, read-items
The following routes are available for this service:
GET/items/{ItemNumber}
POST/items/{ItemNumber}
GetItem Parameters:
NameParameterData TypeRequiredDescription
ItemNumberpathstringYes
LastModifiedAfterbodyDateTime?NoOnly return item if modified after the given date. Ignored for batch requests.

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /items/{ItemNumber} HTTP/1.1 
Host: bestellforum.api.mauve.de 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Mauve.Bestellforum.ServiceModel">
  <ItemNumber>String</ItemNumber>
  <LastModifiedAfter>0001-01-01T00:00:00</LastModifiedAfter>
</GetItem>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<ArrayOfItem xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Mauve.Bestellforum.ServiceModel.Types.Items">
  <Item>
    <AdditionalDescription>String</AdditionalDescription>
    <AuthorInformation>String</AuthorInformation>
    <CalculateBasePrice>false</CalculateBasePrice>
    <CrossSellingItems i:nil="true" />
    <CustomFields i:nil="true" />
    <CustomVatRates xmlns:d3p1="http://schemas.datacontract.org/2004/07/Mauve.Bestellforum.ServiceModel" i:nil="true" />
    <Description>String</Description>
    <DidacticNotes>String</DidacticNotes>
    <Documents i:nil="true" />
    <EAN>String</EAN>
    <Height>0</Height>
    <ItemGroups i:nil="true" />
    <Length>0</Length>
    <Manufacturer>String</Manufacturer>
    <MaxQuantityPerOrder>0</MaxQuantityPerOrder>
    <MediaCodes i:nil="true" />
    <MetaKeywords>String</MetaKeywords>
    <Name>String</Name>
    <Number>String</Number>
    <OrderItemNote>String</OrderItemNote>
    <Price>0</Price>
    <PriceValidUntil>0001-01-01T00:00:00</PriceValidUntil>
    <Prices i:nil="true" />
    <Properties i:nil="true" />
    <ShopText>String</ShopText>
    <ShortDescription>String</ShortDescription>
    <Vat>0</Vat>
    <VatType>String</VatType>
    <VolumePrices i:nil="true" />
    <Weight>0</Weight>
    <Width>0</Width>
  </Item>
</ArrayOfItem>