In our terminology, a design represents a pixel (png, jpg, gif) or vector image (svg) that a customer or partner can use to put it on a product type.
List of all designs in the shop
Method | URL | Example |
---|---|---|
GET | /api/v1/shops/<shopId>/designs |
Example Payload
{
"offset":0,
"limit":10,
"count":2,
"designs":[
{
"id":"163261757",
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
"name":"I love you",
"backgroundColor":"#666666",
"resources":[
{
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757",
"mediaType":"png",
"type":"preview"
}
],
},
{
"id":"163261722",
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261722",
"name":"pinguine",
"resources":[
{
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261722",
"mediaType":"png",
"type":"preview"
}
],
},
]
}
"offset":0,
"limit":10,
"count":2,
"designs":[
{
"id":"163261757",
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
"name":"I love you",
"backgroundColor":"#666666",
"resources":[
{
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757",
"mediaType":"png",
"type":"preview"
}
],
},
{
"id":"163261722",
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261722",
"name":"pinguine",
"resources":[
{
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261722",
"mediaType":"png",
"type":"preview"
}
],
},
]
}
Details about a design
Method | URL | Example |
---|---|---|
GET | /api/v1/shops/<shopId>/designs/<designId> |
A design has the following characteristics:
- Each design has a name, a description, a size and a price. The price is in this case the commission that the owner of the design earns for each usage.
- Images: To retrieve a design image, you can use a URL similar to the following one: https://image.spreadshirtmedia.net/image-server/v1/designs/2484607. These URLs are provided within the resources part of the design payload.
- Color Layers: Vector designs consist of one or more color layers. We provide for each color layer, the original color of the uploaded design as well as the color set by the owner as actual default color. Example:
- Allowed Print Types: For each design, we provide a list of print types, e.g. flock, flex or digital direct print, that can be used to print that design. Vector and pixel images are printed using different print types!
Example Payload
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
"id":"163261757",
"created":"2019-07-08T08:03:56.000+0000",
"modified":"2019-07-22T10:17:39.000+0000",
"name":"I love you",
"description":"A lovely design for you",
"tags":"Love,Love hurts,Love me,Love parade,Love with heart,Loved,Lovestruck,You,Young money,Young wild and free,Your,Youtube,migration,shop api,test",
"user":{
"href":"https://api.spreadshirt.net/api/v1/users/117878306",
"id":"117878306"
},
"size":{
"width":3938.0,
"height":1149.0,
"unit":"px"
},
"colors":[
],
"backgroundColor":"#666666",
"printTypes":[
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/17",
"id":"17"
},
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/1",
"id":"1"
},
],
"designCategories":[
],
"price":{
"vatExcluded":0.00,
"vatIncluded":0.00,
"vat":19.00,
"currency":{
"href":"https://api.spreadshirt.net/api/v1/currencies/1",
"id":"1"
}
},
"resources":[
{
"mediaType":"png",
"type":"preview",
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757,backgroundColor=666666"
},
{
"mediaType":"png",
"type":"montage",
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757"
}
],
}
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/designs/163261757",
"id":"163261757",
"created":"2019-07-08T08:03:56.000+0000",
"modified":"2019-07-22T10:17:39.000+0000",
"name":"I love you",
"description":"A lovely design for you",
"tags":"Love,Love hurts,Love me,Love parade,Love with heart,Loved,Lovestruck,You,Young money,Young wild and free,Your,Youtube,migration,shop api,test",
"user":{
"href":"https://api.spreadshirt.net/api/v1/users/117878306",
"id":"117878306"
},
"size":{
"width":3938.0,
"height":1149.0,
"unit":"px"
},
"colors":[
],
"backgroundColor":"#666666",
"printTypes":[
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/17",
"id":"17"
},
{
"href":"https://api.spreadshirt.net/api/v1/shops/100488332/printTypes/1",
"id":"1"
},
],
"designCategories":[
],
"price":{
"vatExcluded":0.00,
"vatIncluded":0.00,
"vat":19.00,
"currency":{
"href":"https://api.spreadshirt.net/api/v1/currencies/1",
"id":"1"
}
},
"resources":[
{
"mediaType":"png",
"type":"preview",
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757,backgroundColor=666666"
},
{
"mediaType":"png",
"type":"montage",
"href":"https://image.spreadshirtmedia.net/image-server/v1/designs/163261757"
}
],
}