ProductType
General
In our terminology, a product type represents the pure piece or apparel, e.g. a T-shirt, as we get it from our supplier, e.g. American Apparel. A typical product type, e.g. a yellow T-shirt from American Apparel, is illustrated in the picture below. A product type has the following characteristics:
- Each product type has a set of core data, such as name description and price.
- Appearances: A product type has one or more appearances. An appearance describes a pattern/color combination for a piece of apparel, e.g. a yellow T-shirt (no pattern/yellow color) or a camouflage T-shirt (camouflage pattern/light green and dark green as colors). It's important to understand that we are not able to print with each available print type, e.g. flock, flex or digital direct, on each available product type. Therefore, we define for each appearance, which print types are allowed.
- Sizes: A product type has one or more sizes, such as S, M or L. Please note, that size information may vary between different product types. Sizes for adults are for example different from sizes for babys or kids.
- StockStates: Each product type provides stock state information for all allowed appearance/size combinations. We tell you for each combination, whether we have that in stock or not.
- Views: Views describe from which position a human being can look on a specific piece of apparel. Each product type has at least one view. The most common views are apparent: one can look on a piece of apparel from front, back, left and right. However, less apparent is that specific product types have hoods which adds two other views: hood left and hood right. Views for shirts are also different from views for pants. And last but not least, one can also print on the inside areas of certain shirts, e.g. basketball shirts, which adds another set of possible views.
PrintAreas: Print areas describe those parts on a piece of apparel on which we can actually print text and designs using different print types and print colors. Print areas are usually rectangular. However, there are cases where rectangular print area descriptions are not sufficient, for example for T-shirts with v-neck. Another issue is that there might be knobs, pockets or zippers on a T-shirt on which we cannot print - and which we also need to describe. That's the reason why our print area model contains a hard boundary and soft boundary description for each print area. The hard boundary describes the shape inside which one has to position ones text and designs. The soft boundary describes all things inside the hard boundary on which we can't print, e.g. zipper.
ProductType Images
For product types, we deliver the following images:
- Product Type View Images: Product type view images display product types from different viewers perspectives, e.g. front, back, left or right. The most left image in the image list above illustrates such a view image.
(Example: https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/1/appearances/1,width=200,height=200.jpg) - Product Type Size Images: Product type size images illustrates the different product type measures, e.g. arm length, total length or waist size, in an image. The image in the center of the image list above illustrates that.
(Example: https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/variants/size.jpg) - Product Type Detail Images: Product type detail images show how a product type looks like, when worn by a person. The rightmost image illustrates that. Note that these images are not provided for newer product types anymore.
(Example: https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/variants/detail,width=200,height=200.jpg) - Product Type Appearance Images: The image API also returns images for product type appearance, aka product type color/pattern combinations.
(Example: https://image.spreadshirtmedia.net/image-server/v1/appearances/4.jpg) - Print Color Images: The image API also returns images for print colors.
(Example: https://image.spreadshirtmedia.net/image-server/v1/printColors/4,width=200,height=200.jpg)
Resource
While a list resource exists it is recommended to retrieve only the ProductType that is required to display a product. In order to internationalize the returned payload it is possible to specify a locale query parameter.
Method | URL | Example |
---|---|---|
GET | /api/v1/shops/<shopId>/productTypes/<productTypeId> |
The returned payload provides you with extension information about the given ProductType:
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/productTypes/812",
"id":"812",
"name":"Men’s Premium T-Shirt",
"shortDescription":"Classic cut T-shirt for men, 100% cotton. Brand: Spreadshirt",
"description":"The Spreadshirt Collection stands for best-possible print results on top-quality products. A huge range of sizes makes sure that our gear fits everyone, big and small alike. \r\nWhat’s more, the Premium T-shirt offers an sheer infinite choice of combination opportunity with other items.\r\n<ul class=\"listMCE\">\r\n<li>Comes highly recommended! Top quality and supreme print results with all print methods</li>\r\n<li>Consistent colours in all sizes for men, women and children </li>\r\n<li>Fair and sustainable</li>\r\n<li>Durable fabrics. 150g/m²</li>\r\n<li>Material: 100% cotton (charcoal: 50% cotton, 50% polyester, heather blue: 50% cotton, 50% polyester, heather grey: 85% cotton, 15% rayon)</li>\r\n</ul>",
"categoryName":"T-Shirt",
"brand":"Spreadshirt",
"shippingFactor":1.0,
"sizeFitHint":"normal fit",
"manufacturingCountry":{
"href":"https://api.spreadshirt.net/api/v1/shippingCountries/137",
"id":"137"
},
"price":{
"vatExcluded":10.92,
"vatIncluded":12.99,
"vat":19.00,
"currency":{
"href":"https://api.spreadshirt.net/api/v1/currencies/1",
"id":"1"
}
},
"defaultValues":{
"defaultView":{
"id":"1"
},
"defaultAppearance":{
"id":"2"
}
},
"appearances":[
{
"id":"411",
"name":"washed burgundy",
"colors":[
{
"index":0,
"value":"#A95762"
}
],
"printTypes":[
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/2",
"id":"2"
},
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/14",
"id":"14"
},
],
"resources":[
{
"mediaType":"png",
"href":"https://image.spreadshirtmedia.net/image-server/v1/appearances/411"
}
]
},
{
"id":"566",
"name":"heather burgundy",
"colors":[
{
"index":0,
"value":"#914857"
}
],
"printTypes":[
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/2",
"id":"2"
},
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/14",
"id":"14"
},
],
"resources":[
{
"mediaType":"png",
"href":"https://image.spreadshirtmedia.net/image-server/v1/appearances/566"
}
]
},
],
"sizes":[
{
"id":"2",
"name":"S",
"group":"S",
"weight":3.0,
"measures":[
{
"name":"A",
"value":{
"value":710,
"unit":"mm"
}
},
{
"name":"B",
"value":{
"value":455,
"unit":"mm"
}
},
{
"name":"C",
"value":{
"value":203,
"unit":"mm"
}
}
]
},
{
"id":"3",
"name":"M",
"group":"M",
"weight":4.0,
"measures":[
{
"name":"A",
"value":{
"value":735,
"unit":"mm"
}
},
{
"name":"B",
"value":{
"value":510,
"unit":"mm"
}
},
{
"name":"C",
"value":{
"value":210,
"unit":"mm"
}
}
]
},
],
"attributes":[
],
"washingInstructions":[
],
"views":[
{
"id":"1",
"name":"Front",
"perspective":"front",
"resources":[
{
"mediaType":"png",
"href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/1/appearances/2"
}
],
"state":"ACTIVATED"
},
{
"id":"2",
"name":"Back",
"perspective":"back",
"resources":[
{
"mediaType":"png",
"href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/2/appearances/2"
}
],
"state":"ACTIVATED"
},
],
"printAreas":[ ],
"stockStates":[
{
"appearance":{
"id":"1"
},
"size":{
"id":"102"
},
"available":true,
"quantity":354
},
{
"appearance":{
"id":"1"
},
"size":{
"id":"38"
},
"available":true,
"quantity":466
},
{
"appearance":{
"id":"1"
},
"size":{
"id":"94"
},
"available":true,
"quantity":365
},
],
"resources":[
{
"mediaType":"png",
"type":"preview",
"href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/views/1/appearances/2"
},
{
"mediaType":"png",
"type":"size",
"href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/variants/size"
},
{
"mediaType":"png",
"type":"detail",
"href":"https://image.spreadshirtmedia.net/image-server/v1/productTypes/812/variants/detail"
}
],
}