SwiftPOD API
1. Overview
The SwiftPOD API v1 is a API service for viewing the product catalog, inventory, getting order details and completing orders for our printing and fulfillment services.
Requests are made using standard GET and POST. All responses are JSON.
Once you sign up for an account, you will be provided with a real API key (In your account settings).
2. Authentication
This API uses normal method for authentication (API Keys in params). Your private API keys should be used as the password.
If you are currently logged in account settings, you can go to [Setting] -> [API Credentials] and get API Keys there.
All requests must be made over HTTPS.
3. Rate Limit
150 requests per 10 seconds, Block for 1 minute
4. Get Order Information (Trackings)
```java HelloWorld.java
"trackings": [
{
"primary": true, // true: default tracking
"tracking_number": "ABC123",
"tracking_url": "https://tools.usps.com/go/TrackConfirmAction.action?tLabels=ABC123",
"carrier": "USPS",
"created_at": "2022-05-23T09:22:31.000000+00:00",
"status": null
}
],
```
5. Print Area Definition
Key | Explanation |
---|---|
front | Input this key if you wish to print on the front area. |
back | Input this key if you wish to print on the back area. |
inner_neck_label | Located on the inside of the garment, usually containing vital details like the country of manufacturing origin, original garment size, and material specifics. You only need to upload your logo, and the remaining required information will be automatically updated based on the specifications of the shirt. |
outer_neck_label | Located on the outside of the garment underneath the collar. This area offers ample space for incorporating branding elements such as logos, slogans, or additional information. |
Use this key if you wish to print on the pocket area of the product. | |
above_pocket | This key is for printing on the area above the pocket of the product. |
left_sleeve | Use this key if you intend to print on the left sleeve of the garment. |
right_sleeve | Use this key if you intend to print on the right sleeve of the garment. |
3df | This key indicates the use of UV 3D printing method on the front area of the product. |
emb_front_small | This key signifies embroidering on the front area of the product. |
emb_left_chest | This key signifies embroidering on the left chest area of the product. |
bleed_mug | This key indicates the use of print on bleed mug. Print area "bleed_mug" is exclusively available for specific SKUs mentioned here |
dtf_f | This key signifies printing on the front area of the product using Direct-to-Film technology. |
dtf_b | This key signifies printing on the back area of the product using Direct-to-Film technology. |
dtf_pocket | This key signifies printing on the pocket area of the product using Direct-to-Film technology. |
dtf_above_pocket | This key signifies printing on the above pocket area of the product using Direct-to-Film technology. |
maxprint | This key signifies printing on the largest area of the mug, covering almost the entire surface.Print area "maxprint" is exclusively available for specific SKUs mentioned here. |
poster | This key indicates the use of print on poster. Print area "poster" is exclusively available for specific SKUs mentioned here here. |
6. Available SKUs for Bleed Mug Print Area
View the list
# | SKU | Product Name |
---|---|---|
1 | MUGS1W11O | MUGS / WHITE / 11 oz |
2 | MUGS1W15O | MUGS / WHITE / 15 oz |
3 | MUHC1C11O | MUHC / BLUE / 11 oz |
4 | MUHC1C15O | MUHC / BLUE / 15 oz |
5 | MUHC1R11O | MUHC / RED / 11 oz |
6 | MUHC1R15O | MUHC / RED / 15 oz |
7 | MUHC1P11O | MUHC / PINK / 11 oz |
8 | MUHC1P15O | MUHC / PINK / 15 oz |
9 | MUHCH711O | MUHC / LIGHT GREEN / 11 oz |
10 | MUHCH715O | MUHC / LIGHT GREEN / 15 oz |
11 | MUHC5R11O | MUHC / MAROON / 11 oz |
12 | MUHC5R15O | MUHC / MAROON / 15 oz |
13 | MUHC1O11O | MUHC / ORANGE / 11 oz |
14 | MUHC1O15O | MUHC / ORANGE / 15 oz |
15 | MUHC1Y11O | MUHC / YELLOW / 11 oz |
16 | MUHC1Y15O | MUHC / YELLOW / 15 oz |
17 | MUHC1B11O | MUHC/ BLACK / 11 oz |
18 | MUHC1B15O | MUHC/ BLACK / 15 oz |
19 | MUHC4N11O | MUHC/ LIGHT BLUE / 11 oz |
20 | MUHC4N15O | MUHC /LIGHT BLUE / 15 oz |
21 | MUHC1D11O | MUHC / COBALT /11 oz |
22 | MUHC1D15O | MUHC / COBALT / 15 oz |
23 | MUHCQ311O | MUHC / LIGHT YELLOW /11 oz |
24 | MUHCQ315O | MUHC/ LIGHT YELLOW / 15 oz |
25 | CMUG1B11O | CMUG/ BLACK / 11 oz |
7. Available SKUs for Maxprint Print Area
View the list
| # | SKU | Product Name | |----|------------|----------------------------| | 1 | MUHC1B11O | MUHC / BLACK / 11 oz | | 2 | MUHC1B15O | MUHC / BLACK / 15 oz | | 3 | MUHC1C11O | MUHC / BLUE / 11 oz | | 4 | MUHC1C15O | MUHC / BLUE / 15 oz | | 5 | MUHC1O11O | MUHC / ORANGE / 11 oz | | 6 | MUHC1O15O | MUHC / ORANGE / 15 oz | | 7 | MUHC1P11O | MUHC / PINK / 11 oz | | 8 | MUHC1P15O | MUHC / PINK / 15 oz | | 9 | MUHC1R11O | MUHC / RED / 11 oz | | 10 | MUHC1R15O | MUHC / RED / 15 oz | | 11 | MUHC1Y11O | MUHC / YELLOW / 11 oz | | 12 | MUHC4N11O | MUHC / LIGHT BLUE / 11 oz | | 13 | MUHC4N15O | MUHC / LIGHT BLUE / 15 oz | | 14 | MUHC5R11O | MUHC / MAROON / 11 oz | | 15 | MUHCH711O | MUHC / LIGHT GREEN / 11 oz | | 16 | MUGS1C11O | MUGS / BLUE / 11 oz | | 17 | MUGS1C15O | MUGS / BLUE / 15 oz | | 18 | MUGS1W11O | MUGS / WHITE / 11 oz | | 19 | MUGS1W15O | MUGS / WHITE / 15 oz |8. Available SKUs for Poster Print Area
View the list
| # | SKU | Product Name | |----|------------|----------------------------| | 1 | POST1W303 | Satin Paper Poster / WHITE / 30x30 Inches | | 2 | POST1W242 | Satin Paper Poster / WHITE / 24x24 Inches | | 3 | POST1W161 | Satin Paper Poster / WHITE / 16x16 Inches | | 4 | POST1W324 | Satin Paper Poster / WHITE / 32x48 Inches | | 5 | POST1W243 | Satin Paper Poster / WHITE /24x36 Inches| | 6 | POST1W162 | Satin Paper Poster / WHITE / 16x24 Inches | | 7 | POST1W121 | Satin Paper Poster / WHITE / 12x18 Inches | | 8 | POST1W081 | Satin Paper Poster / WHITE / 8x12 Inches |AUTHORIZATION Bearer token
Token
API_KEY
Last modified: 6 days ago