Seller API Documentation

Products CREATE

Purpose/Overview

This request is for creating a single product for a seller.

URL

POST /seller_api/products?v=1.1

cURL Example

curl https://dawanda.com/seller_api/products?v=1.1 \
  -X POST \
  -d "@my_product.xml" \
  -H "Content-Type: text/xml" \
  -H "X-Dawanda-Auth: YOUR_API_KEY"

Success Response(s)

A successful request will respond with an XML response with a relative URL to the products page:

<product url="URL" status="success" />

Example:

<product url="/product/123-my-product" status="success" />

Failure Responses

When an error has occurred, the API will respond with an appropriate HTTP Status code. The response body will contain an XML document containing a human readable error message and additional details (if any).

Relevant Information

When creating or updating products, images are asynchronously downloaded from the URLs provided. However, the API issues a synchronous HTTP HEAD request to determine if the image URLs are valid. If the HTTP HEAD request returns a non-200 status code, the create/update will fail with a 422 Record Invalid error response.

Allowed values for the mailable_in attribute:

11: delivery within 1-2 days
12: delivery within 3-5 days
13: delivery within 6-9 days
14: delivery within 10-14 days
15: delivery within 15-21 days
21: delivery within 4 weeks
22: delivery within 5 weeks
23: delivery within 6 weeks
24: delivery within 7 weeks
25: delivery within 8 weeks
26: delivery within 9 weeks
27: delivery within 10 weeks

Constraints

This request requires authentication.

Schema

v1.0 Schema: Product.xsd
v1.1 Schema: Product.xsd

Example XML

Link to XML: Product.xml