POST api/v2/products/stonefamilies

Used to retrieve available stone families in a mounting's stone location(s).

Request Information

URI Parameters

None.

Body Parameters

StoneFamiliesRequest
NameDescriptionTypeAdditional information
ConfigurationModelId

The id of the configuration of a product.

integer

None.

LocationNumbers

Collection of integer

None.

Locations

Collection of LocationDimensions

None.

StoneGroups

The list of stones in the group.

Collection of string

None.

Request Formats

Sample:

{
  "ConfigurationModelId": 1,
  "LocationNumbers": [
    1,
    2
  ],
  "Locations": [
    {
      "LocationNumber": 1,
      "Dimension1": 2.0,
      "Dimension2": 3.0,
      "Dimension3": 4.0,
      "Shape": "sample string 5",
      "SettingType": "sample string 6"
    },
    {
      "LocationNumber": 1,
      "Dimension1": 2.0,
      "Dimension2": 3.0,
      "Dimension3": 4.0,
      "Shape": "sample string 5",
      "SettingType": "sample string 6"
    }
  ],
  "StoneGroups": [
    "sample string 1",
    "sample string 2"
  ]
}

Sample:

<StoneFamiliesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ConfigurationModelId>1</ConfigurationModelId>
  <LocationNumbers xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:int>1</d2p1:int>
    <d2p1:int>2</d2p1:int>
  </LocationNumbers>
  <Locations>
    <LocationDimensions>
      <Dimension1>2</Dimension1>
      <Dimension2>3</Dimension2>
      <Dimension3>4</Dimension3>
      <LocationNumber>1</LocationNumber>
      <SettingType>sample string 6</SettingType>
      <Shape>sample string 5</Shape>
    </LocationDimensions>
    <LocationDimensions>
      <Dimension1>2</Dimension1>
      <Dimension2>3</Dimension2>
      <Dimension3>4</Dimension3>
      <LocationNumber>1</LocationNumber>
      <SettingType>sample string 6</SettingType>
      <Shape>sample string 5</Shape>
    </LocationDimensions>
  </Locations>
  <StoneGroups xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
  </StoneGroups>
</StoneFamiliesRequest>

Response Information

Resource Description

StoneFamiliesResponse
NameDescriptionTypeAdditional information
StoneFamilies

List of the stone families that will be returned.

Collection of StoneFamily

None.

Response Formats

Sample:

{
  "StoneFamilies": [
    {
      "StoneGroup": "sample string 1",
      "LocationNumber": 1,
      "Name": "sample string 2",
      "Categories": [
        "sample string 1",
        "sample string 2"
      ],
      "CategoriesWithSerializedIndicator": [
        {
          "CategoryName": "sample string 1",
          "IsSerialized": true
        },
        {
          "CategoryName": "sample string 1",
          "IsSerialized": true
        }
      ]
    },
    {
      "StoneGroup": "sample string 1",
      "LocationNumber": 1,
      "Name": "sample string 2",
      "Categories": [
        "sample string 1",
        "sample string 2"
      ],
      "CategoriesWithSerializedIndicator": [
        {
          "CategoryName": "sample string 1",
          "IsSerialized": true
        },
        {
          "CategoryName": "sample string 1",
          "IsSerialized": true
        }
      ]
    }
  ]
}

Sample:

<StoneFamiliesResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <StoneFamilies>
    <StoneFamily>
      <Categories xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>sample string 1</d4p1:string>
        <d4p1:string>sample string 2</d4p1:string>
      </Categories>
      <CategoriesWithSerializedIndicator>
        <StoneFamilyCategoryWithSerializedIndicator>
          <CategoryName>sample string 1</CategoryName>
          <IsSerialized>true</IsSerialized>
        </StoneFamilyCategoryWithSerializedIndicator>
        <StoneFamilyCategoryWithSerializedIndicator>
          <CategoryName>sample string 1</CategoryName>
          <IsSerialized>true</IsSerialized>
        </StoneFamilyCategoryWithSerializedIndicator>
      </CategoriesWithSerializedIndicator>
      <LocationNumber>1</LocationNumber>
      <Name>sample string 2</Name>
      <StoneGroup>sample string 1</StoneGroup>
    </StoneFamily>
    <StoneFamily>
      <Categories xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>sample string 1</d4p1:string>
        <d4p1:string>sample string 2</d4p1:string>
      </Categories>
      <CategoriesWithSerializedIndicator>
        <StoneFamilyCategoryWithSerializedIndicator>
          <CategoryName>sample string 1</CategoryName>
          <IsSerialized>true</IsSerialized>
        </StoneFamilyCategoryWithSerializedIndicator>
        <StoneFamilyCategoryWithSerializedIndicator>
          <CategoryName>sample string 1</CategoryName>
          <IsSerialized>true</IsSerialized>
        </StoneFamilyCategoryWithSerializedIndicator>
      </CategoriesWithSerializedIndicator>
      <LocationNumber>1</LocationNumber>
      <Name>sample string 2</Name>
      <StoneGroup>sample string 1</StoneGroup>
    </StoneFamily>
  </StoneFamilies>
</StoneFamiliesResponse>