Multi-Storefront Management in Venddor IO

Introduction

Navigating through an e-commerce landscape with multiple storefronts can be challenging. Venddor IO simplifies this by offering a central administrative platform. With a unified database, each storefront functions as an independent entity, complete with distinct settings, visuals, and checkout processes, enhancing user experience.

Listing All Stores

To access a comprehensive view of all your stores:

GET /api/stores/

This endpoint provides a detailed list of all stores in the Venddor IO system. Adjusting the output is possible by integrating pagination parameters.

Pagination, Sorting, and Filtering

You can customize the response by appending specific parameters:

page: Determines the page number
items_per_page: Defines the number of stores per page
sort_by: Sets the criteria for sorting, either by name or timestamp
sort_order: Establishes the order, either ascending (asc) or descending (desc)
timestamp: Filters stores based on creation time
company: Retrieves a specific store by name

If you wish to view two stores from the second page:

GET /api/stores/?page=2&items_per_page=2

Or, to search for a store named "Simtech":

GET /api/stores/?company=Simtech

Understanding the Response

Executing a test request like:

GET /api/stores/?items_per_page=1

If successful, you will receive HTTP/1.1 200 OK along with JSON data detailing the stores.

Accessing a Specific Store

Delve deeper into a specific store's details using its unique company ID:

GET /api/stores/1

Understanding Store Attributes

Each storefront in Venddor IO is characterized by unique attributes. Notable fields include company_id, company (store's name), timestamp (creation time), and storefront (the URL of the storefront).

Creating a New Storefront

To establish a new storefront:

POST /api/stores/

Essential fields include company (store's name) and storefront (URL). The storefront URL must be distinctive for each store.

Updating a Storefront

Modify an existing storefront using:

PUT /api/stores/2/

Changes can range from basic store details like name or URL to comprehensive company information.

Deleting a Storefront

If the need arises to remove a storefront:

DELETE /api/stores/2