Introduction to the basic DaWanda API
The DaWanda API provides a simple RESTful interface with XML and JSON response formats. The API reveals a lot of DaWanda’s website information such as public user-profiles, shops, products and categories. This document provides information concerning the integration of the DaWanda API into custom web applications.
The DaWanda API requires an api key which can be activated here. The key is a 40 character SHA1 hash which identifies you as a unique API user and is used to track your requests. At the moment, the DaWanda API enables you to access public information. That makes an additional login process unnecessary.
The DaWanda API is based on a RESTful interface that can be used with standard HTTP GET calls. You can generate those HTTP requests with your browser or with a programming language of your choice, e.g. PHP, Ruby, Java, etc.
HTTP Status Codes
The DaWanda API uses standard HTTP status codes to indicate the sucess or failure of your API request. Status codes are part of a HTTP response. A good page for HTTP status codes is the W3C reference page, which can be found here. For a description of all possible status codes please read the section Standard Response Codes which can be found below.
To avoid an overload of requests we established a request throttling. DaWanda API clients are allowed to make 1000 requests per hour. If you want to make more requests with your application, contact us at firstname.lastname@example.org. Please send a description of your application and a rough estimation of how many requests you are expecting.
Pagination of results
The default size of a returned result is 10, the maximum is 100. If you search for all products of a specific user, the API will return 10 products as a default. If you want a larger number of returned results with one request you can specify individual parameter settings using the following query parameters: count, page or per_page. By specifying these parameters you can navigate through large sets of results more easily.
DaWanda supports 3 lanuages: German, English and French. To obtain the requested information (e.g. product, category) in a specific language you need to change the request domain. If you would like to receive a product’s desciption in English just set the request Domain to en.dawanda.com. Other possible values are de.dawanda.com for German translations and fr.dawanda.com for French translations.