Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  • api.spreadshirt.net and
  • image.spreadshirtspreadshirtmedia.net

and for the North American market

  • api.spreadshirt.com and
  • image.spreadshirtspreadshirtmedia.com.

Do I need an API key to work on the API?

No. You can access most of the shop resources, such as shop designs, articles and categories without any security restrictions. This makes playing around with the API and finding out whether this is what you need as simple as possible for you. However, in case you want to write real applications, such as your own shop, mass-customization applications or integration, you will need an API key!Yes. 

How can I get an API key?

...

Your API key works by default on the one platform only you registered for.

How

...

Use the API browser to browse the API conveniently. The API browser not only allows you to conduct HTTP GET requests on API URLs but also to conduct POST, PUT and DELETE requests. It also provides a set of request templates that make your live easier.

How do I earn money, selling articles and custom created products via my custom client application using the API?

...

You can create products via your application and use your shop's checkout. I guess you will get about 20% commission for each sold product automatically. You need to use the shop checkout in this case.

Why does article/design search not work for my shop?

Search is right now only implemented for the Spreadshirt marketplace. For each platform, i.e. eu and na, we operate one marketplace right now. You can reach the marketplaces for eu and na platform on shop ids 205909 (eu) and 93439 (na).

How can I

...

For each platform, i.e. eu and na, we operate one marketplace right now. You can reach the marketplaces for eu and na platform on shop ids 205909 (eu) and 93439 (na). You can search on articles and designs on each marketplace. Sample urls are:

How can I switch the marketplace language?

For each platform, i.e. eu and na, we operate one marketplace right now. You can reach the marketplaces for eu and na platform on shop ids 205909 (eu) and 93439 (na).

Each marketplace is also available in different languages. The marketplace eu is for example available in german, english or french. You can switch the language by providing the locale parameter in your URLs. Sample urls are:

How can I check, whether my design/article is indexed on the marketplace for a specific language?

For each marketplace article/design, we index the Spreadshirt article/design id. Therefore, you can check easily whether your marketplace design/article is indexed by searching for the id. Sample URL is:

http://api.spreadshirt.net/api/v1/shops/205909/designs?query=2484607&locale=de_DE

How can I upload designs to Spreadshirt from my custom application?

...

For more details on how to work with the basket API read the article about the basket model. To retrieve the checkout URL for either the marketplace or the shop checkout, you need in general to call a URL similar to the following one: httphttps://api.spreadshirt.net/api/v1/shops/205909/baskets/123/checkout. This is also described in detail in on the basket resources page.

...

code
Code Block
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<design xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns="http://api.spreadshirt.net">
<name>Super cool design</name>
<description>A super cool design</description>
</design>