API Documentation - Product List

Endpoint

GET /product/list

Parameters

The following query parameters are supported in the request:

Parameter Type Description Required
fam1ID string A unique identifier of category No
fam2ID string A unique identifier of sub-category No
guid string A unique identifier for the session or user No
id_membre int The member ID Yes
from_other_page string Specifies the context from which the request is made. Possible values: IS_FAVORIS, IS_PROMOTION, IS_NOUVEAUTE No
megatech_ARCLEUNIK string Unique product identifier No
GPR_No string Group number. Defaults to "01" if not provided No
rechercher_mot_cle string Keyword for searching products No
champstraduit string Specifies the translated field to be used. Possible values: megatech_Titre_lib_web_fr, megatech_Titre_lib_web_nl, megatech_Titre_lib_web_en No
limit int The number of records to return No
page int The page number to start from No
tri_listing_article string Specifies the sorting order. Possible values: weborder, alpha No
data string Semi-colon separated string for filtering products by specific attributes (formatted as 'valueBefore_valueAfter') No

Response

The response is a JSON object containing the following fields:

{
    "success": true,
    "message": "Products list",
    "result": {
        "product": [
            {
                "id_product_mysql": 1,
                "arcleunik": "1234",
                "title": "Hammer",
                "productCode": "HMR001",
                "champsLangueAutiliser": "Hammer",
                "fam1ID": 2,
                "fam2ID": 3,
                "active": true,
                "qtyByBox": 10,
                "unite": "piece",
                "unite_full_name": "Piece",
                "tvaRate": 20.0,
                "weborder": 1,
                "promoPrice": 15.99,
                "promoPriceStart": "2024-01-01",
                "promoPriceEnd": "2024-12-31",
                "libWebLangue1": "Hammer",
                "libWebLangue2": "Hammer",
                "libWebLangue3": "Hammer",
                "isNew": false,
                "libWeb": "High-quality hammer",
                "langue_libweb_1": "Hammer description in language 1",
                "langue_libweb_2": "Hammer description in language 2",
                "langue_libweb_3": "Hammer description in language 3",
                "langue_libweb_4": "Hammer description in language 4",
                "photo1_base64": "base64encodedstring",
                "prix_vente_groupe": 20.99,
                "prix_en_promo": 15.99
            }
        ],
        "product_out_of_shop": [
            {
                "arcleunik": "5678",
                "productCode": "HMR002",
                "titre_produit": "Sledgehammer",
                "champsLangueAutiliser": "Sledgehammer",
                "fam1ID": 2,
                "fam2ID": 3
            }
        ]
    }
}

Example Request

GET /product/list?guid=12345&id_membre=678&from_other_page=IS_PROMOTION&rechercher_mot_cle=tools&limit=20&page=1&tri_listing_article=alpha

Example Response

{
    "success": true,
    "message": "Products list",
    "result": {
        "product": [
            {
                "id_product_mysql": 1,
                "arcleunik": "1234",
                "title": "Hammer",
                "productCode": "HMR001",
                "champsLangueAutiliser": "Hammer",
                "fam1ID": 2,
                "fam2ID": 3,
                "active": true,
                "qtyByBox": 10,
                "unite": "piece",
                "unite_full_name": "Piece",
                "tvaRate": 20.0,
                "weborder": 1,
                "promoPrice": 15.99,
                "promoPriceStart": "2024-01-01",
                "promoPriceEnd": "2024-12-31",
                "libWebLangue1": "Hammer",
                "libWebLangue2": "Hammer",
                "libWebLangue3": "Hammer",
                "isNew": false,
                "libWeb": "High-quality hammer",
                "langue_libweb_1": "Hammer description in language 1",
                "langue_libweb_2": "Hammer description in language 2",
                "langue_libweb_3": "Hammer description in language 3",
                "langue_libweb_4": "Hammer description in language 4",
                "photo1_base64": "base64encodedstring",
                "prix_vente_groupe": 20.99,
                "prix_en_promo": 15.99
            }
        ],
        "product_out_of_shop": [
            {
                "arcleunik": "5678",
                "productCode": "HMR002",
                "titre_produit": "Sledgehammer",
                "champsLangueAutiliser": "Sledgehammer",
                "fam1ID": 2,
                "fam2ID": 3
            }
        ]
    }
}