Products Sync V3

The Sync Products API is an interface that must be implemented on the system on which you want to integrate Zakeke, to allow the exchange and synchronization of the product catalog.

You can implement this API using any technology stack. You can read here a basic implementation of it in php.

Sync Products

Each product in your system can contain one or multiple variants (some ecommerce platforms would call these options) that the customer can purchase (imagine multiple sizes or colors of the same t-shirt design).

The purpose of Products Sync API is to let you link each product from your system that will be available for the configuration by Zakeke.

Authentication

Each request is authenticated by http basic auth by using using your Zakeke api client id as username and your secret key as password. You can find your api keys from this page.

Pagination

API responses must support pagination by a parameter named page in the query string. Pages have index 1. The api must return an empty list when the requested page doesn't have any elements.

Product properties

code	"code": "242422342" A unique numeric identifier for the product. Each id is unique across your system.
name	"name": "Woman handbag" The name of the product.
thumbnail	"thumbnail": "https://urlOfTheproduct" An image associated with the product.

 

Product option properties

code	"code": "34523" The unique numeric identifier for the product option.
name	"name": "Color" The name of the product option.
values	"values": [ { "code": "537564567", "name": "White" }, { "code": "646456464", "name": "Black" } ] The possible values ​​of the product option.

 

Product option value properties

code	"code": "537564567" The unique numeric identifier for the option value.
name	"name": "White" The name of the option value.

 

Required endpoints

These are the endpoints to be implemented on your system that are required for the Product Sync API integration:

GET https://yourSystem/productSyncAPI
Retrieves a list of products.
page	Return a specific page of results. (default: 1)
search	Filter results by product name or code.
Retrieve all products GET https://yourSystem/productSyncAPI Response HTTP/1.1 200 OK [ { "code":"1343242", "name":"Woman handbag", "thumbnail":"https://imageUrl" }, { "code":"1343243", "name":"Watch", "thumbnail":"https://imageUrl" } ]

Retrieves a list of product options.

Retrieve all options for a product

GET https://yourSystem/productSyncAPI/{product_code}/options

Response

HTTP/1.1 200 OK

[
   {
      "code":"34523",
      "name":"Color",
      "values": [
         {
            "code": "537564567",
            "name": "White"
         },
         {
            "code": "646456464",
            "name": "Black"
         }
      ]
   }
]

Mark the product as configurable in your system

Link a product on your system with a Zakeke configuration.

POST https://yourSystem/productSyncAPI/{product_code}/configurator

HTTP/1.1 200 OK

Mark the product as not longer configurable in your system

Unlink a product on your system with a Zakeke configuration.

DELETE https://yourSystem/productSyncAPI/{product_code}/configurator

HTTP/1.1 200 OK