SnappShop Sellers for WooCommerce

Description

SnappShop Sellers for WooCommerce makes published product catalog data available to SnappShop Seller Center through a configurable REST API. It provides endpoints for products, product categories, and global attributes. The plugin does not publish products to SnappShop, send orders, or change your WooCommerce catalog.

You need WooCommerce and a SnappShop Seller Center account to use the connection. Learn about Seller Center at https://seller.snappshop.ir/.

Features:

• Read-only endpoints for published products, categories, and global attributes.
• Product search, filters, and pagination, including stock information.
• Configurable API base URI.
• Optional Bearer token protection, enabled by default on new installations.
• A Persian settings page showing the base URL and token controls.

The API is available under /wp-json/{base_uri}/. The default base URI is snappshop-seller:

• GET /wp-json/snappshop-seller/products/?page=1&per_page=50
• GET /wp-json/snappshop-seller/products/{product_code}
• GET /wp-json/snappshop-seller/resolve?url={store_page_url}
• GET /wp-json/snappshop-seller/categories
• GET /wp-json/snappshop-seller/attributes

Categories and attributes return up to 1,000 entries per page. Categories without a published in-stock product are omitted. Add ?page=2 to either URL for the next page. Each attribute includes up to five options and an array of related category names. Category associations are batched and cached for five minutes. These endpoints return a data array without pagination metadata.

The product list also supports search and filters for category, tag, brand, type, visibility, stock status, featured status, sale status, price, and ordering. Successful responses use a status flag and a data object. See the bundled README.md for endpoint and filter details.

The resolver accepts a URL from this store and returns the corresponding seller catalog API URL for product, shop, category, tag, brand, and product-search pages. It returns status: false when the URL or its filters cannot be resolved.

Service and privacy

The plugin does not contact SnappShop servers on its own. When you give your API base URL and, if enabled, Bearer token to SnappShop Seller Center, that service can request catalog data from your site. Enabled endpoints return published product information such as names, descriptions, prices, stock, image URLs, categories, and attributes. The plugin does not expose customer or order data through these endpoints.

If you turn off Bearer token protection, anyone who can reach the enabled endpoints can request this catalog data. Turning off the API disables these routes. Use HTTPS for your public store and keep the token private.