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:
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.
For product types, we deliver the following images:
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> | https://api.spreadshirt.net/api/v1/shops/100488332/productTypes/812?mediaType=json |
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" } ], } |