API Documentation

Wexl Grupp API Overview

The Wexl Grupp API provides a straightforward RESTful (JSON-only) interface over HTTPS, allowing third-party applications to access the features of the Wexl Grupp e-commerce platform. Designed according to RESTful principles, the API is stateless and leverages standard HTTP methods and response codes wherever possible.

This document is intended for customers who want to integrate Wexl Grupp functionality into their own applications.

Base URL for all requests: https://api.b2b.wexlgrupp.ee/

Revision History

Authentication

All API requests require an API key included in the request headers. This key identifies your application and allows you to access the API securely.

Header Format

X-API-Key: <your-api-key>

How to Obtain an API Key

You can obtain your API key from your Wexl Grupp B2B My account section. Keep your key secret and do not share it publicly.

Example Request

curl -H "X-API-Key: YOUR_API_KEY" https://api.b2b.wexlgrupp.ee/v1/products

Security Tips

• Do not embed API keys directly in client-side code.
• Rotate your API keys regularly.
• Use HTTPS for all requests to protect your API key in transit.

Errors

The API uses standard HTTP status codes to indicate errors. Error responses follow the format {"error": "message"}.

• 400 Bad Request: The request was invalid (e.g., missing parameter, non-existent product ID, invalid data format).
• 401 Unauthorized: Missing or invalid API key.
• 404 Not Found: Requested resource does not exist (e.g., product/category list is empty).
• 405 Method Not Allowed: HTTP method used is not allowed for the resource.
• 500 Internal Server Error: Something went wrong on the server (e.g., missing configuration, exception).

Available Request Parameters

GET Requests

You can filter GET endpoints using query parameters. Example for /products:

POST Requests (Request Body)

POST requests accept a JSON body. Example for creating an order:

{
  "products": [
    { "id": "12345678", "quantity": 2 },
    { "id": "87654321", "quantity": 1 }
  ]
}

Brands

GET /v1/brands

Returns all available brands.

Example Request

curl -X GET "https://api.b2b.wexlgrupp.ee/v1/brands" -H "X-API-Key: YOUR_KEY"

{
  "brands": [
    { "id": 1, "name": "Apple" },
    { "id": 2, "name": "Samsung" }
  ]
}

{
  "error": "No brands found"
}

Categories

GET /v1/categories

Returns all available categories with names in all supported languages.

Example Request

curl -X GET "https://api.b2b.wexlgrupp.ee/v1/categories" -H "X-API-Key: YOUR_KEY"

{
  "categories": [
    {
      "id": 1,
      "name": {
        "en": "Phones",
        "et": "Telefonid",
        "ru": "Телефоны"
      }
    },
    {
      "id": 2,
      "name": {
        "en": "Laptops",
        "et": "Sülearvutid",
        "ru": "Ноутбуки"
      }
    }
  ]
}

{
  "error": "No categories found"
}

{
  "error": "No languages found"
}

Products

curl -X GET "https://api.b2b.wexlgrupp.ee/v1/products?brands=1,2&lang=en" -H "X-API-Key: YOUR_KEY"

{
  "products": [
    {
      "id": "12345678",
      "ean": "0123456789123",
      "name": { "en": "iPhone 15" },
      "brand": { "id": 1, "name": "Apple" },
      "category": { "id": 3, "name": "Phones" },
      "short_desc": { "en": "The newest iPhone." },
      "full_desc": { "en": "..." },
      "images": [ "https://b2b.wexlgrupp.ee/img/p/1/2/3/123.jpg" ],
      "price": 999.00,
      "retail_price": 1099.00,
      "stock": 50,
      "features": [
        { "id": 1, "name": "Color", "value": "Black" }
      ]
    }
  ]
}

{
  "error": "Language missing - xyz"
}

{
  "error": "No products found"
}

curl -X GET "https://api.b2b.wexlgrupp.ee/v1/products/42" -H "X-API-Key: YOUR_KEY"

{
  "products": {
    "id": "12345678",
    "ean": "0123456789123",
    "name": { "en": "iPhone 15" },
    "brand": { "id": 1, "name": "Apple" },
    "category": { "id": 3, "name": "Phones" },
    "short_desc": { "en": "The newest iPhone." },
    "full_desc": { "en": "..." },
    "images": [ "https://b2b.wexlgrupp.ee/img/p/1/2/3/123.jpg" ],
    "price": 999.00,
    "retail_price": 1099.00,
    "stock": 50,
    "features": [
      { "id": 1, "name": "Color", "value": "Black" }
    ]
  }
}

{
  "error": "Product not found"
}

Orders

POST /v1/orders

Creates a new order for the customer. Products are identified by their ID.

Request Body

{
  "products": [
    { "id": "12345678", "quantity": 2 },
    { "id": "87654321", "quantity": 1 }
  ]
}

Example Request

curl -X POST "https://api.b2b.wexlgrupp.ee/v1/orders" -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" -d '{"products": [{"id": "12345678", "quantity": 2}]}'

{
  "id": "AZERTY",
  "status": "created"
}

{
  "error": "Missing products"
}
/* OR */
{
  "error": "Missing required field: id"
}
/* OR */
{
  "error": "Could not find pricelist"
}
/* OR */
{
  "error": "Non-existing id"
}

{
  "error": "Customer does not have addresses"
}
/* OR */
{
  "error": "Payment module disabled"
}
/* OR */
{
  "error": "PrestaShop general exception message"
}