s1 API Host

<back to all web services

GetProductsForACarRequest

The following routes are available for this service:
GET, OPTIONS/api/products/car/{carId}Search for products for a given car.User has to be authenticated to search for products.
Parameters:
NameParameterData TypeRequiredDescription
CarIdpathlongYesThe car type id as specified in HBASE (for example "FIA123").
CategoryIdquerystringNoThe product category to retrieve products from.
GenericArticleIdsquerystringNoThe TecDoc GenericArticleId's (The group Id's). Comma-separated.
LicensePlatequerystringNoThe license plate of the given car. The license plate is required when you are searching for products in the mpm oil category. It won't be used for anything else. The Car Id is still our primary key for searching.
SkipqueryintNoThe amount of search results that need to be skipped. Default value is 0.
TakequeryintNoThe amount of search results that need to be taken. Default value is 25.
SortKeyquerystringNoThe key on which the sort needs to be applied. There is no default sorting applied.
SortDirectionquerystringNoThe direction in which the sorting needs to be applied. SortKey is a required field if you use this parameter. There is no default sort direction applied.
IncludeFilterOptionsqueryboolNoDefault is false. If set to true, will return the filter options for the given products.
IncludeAssetsqueryboolNoDefault is false. If set to true, will return extra assets for the given products.
WithoutRouteInfoqueryboolNoIf set to true, will not return route info which will decrease response times.
WithoutNettoPricequeryboolNoIf set to true, will not return net prices which will decrease response times.

To override the Content-type in your clients 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 /xml/reply/GetProductsForACarRequest HTTP/1.1 
Host: api2.ghs-automotive.nl 
Content-Type: application/xml
Content-Length: length

<GetProductsForACarRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/S1.Api.Domain.Models.Products">
  <IncludeAssets>false</IncludeAssets>
  <IncludeFilterOptions>false</IncludeFilterOptions>
  <Skip>0</Skip>
  <SortDirection>String</SortDirection>
  <SortKey>String</SortKey>
  <Take>0</Take>
  <WithoutNettoPrice>false</WithoutNettoPrice>
  <WithoutRouteInfo>false</WithoutRouteInfo>
  <CarId>String</CarId>
  <CategoryId>String</CategoryId>
  <GenericArticleIds>String</GenericArticleIds>
  <LicensePlate>String</LicensePlate>
</GetProductsForACarRequest>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetProductsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/S1.Api.Domain.Models.Products">
  <Assets xmlns:d2p1="http://schemas.datacontract.org/2004/07/S1.Api.Domain.Models.Products.Assets" i:nil="true" />
  <DebugInfo xmlns:d2p1="http://schemas.datacontract.org/2004/07/S1.Api.Domain.Models">
    <d2p1:Durations xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays" i:nil="true" />
    <d2p1:TotalDuration>0</d2p1:TotalDuration>
  </DebugInfo>
  <FilterOptions xmlns:d2p1="http://schemas.datacontract.org/2004/07/S1.Api.Domain.Models.Products.Filter" i:nil="true" />
  <IsTruncated>false</IsTruncated>
  <Products i:nil="true" />
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
      </d2p1:ResponseError>
    </d2p1:Errors>
  </ResponseStatus>
  <SpecialToolProducts i:nil="true" />
  <TotalResults>0</TotalResults>
  <UrgentMessages xmlns:d2p1="http://schemas.datacontract.org/2004/07/S1.Api.Domain.Models.UrgentMessages" i:nil="true" />
</GetProductsResponse>