External API – configuratore per simbolo

Endpoint

GET https://external-api.mddlinx.com/externalapi/configurator/{symbol}

Restituisce la definizione completa del prodotto per il simbolo specificato (SKU): nomi in diverse lingue, gerarchia del catalogo, parametri tecnici, attributi di configurazione, prezzi, ecotassa, accessori e commenti. L’endpoint è pubblico – non richiede l’intestazione Authorization né token.

Request

Headers

Accept string

Possible values: application/json

Tipo di risposta previsto.

Default value: application/json

Response

JSON

{
  "Sku": "MIT1RP",
  "IndexSAP": "000500000581900000",
  "Name": [
    { "LangSymbol": "EN", "Value": "Mito executive desk" },
    { "LangSymbol": "PL", "Value": "Biurko gabinetowe Mito" }
  ],
  "Hierarchy": {
    "Child": {
      "Hierarchy_Id": "07",
      "Hierarchy_Symbol": "h1",
      "Description": [
        { "LangSymbol": "EN", "Value": "MDD" },
        { "LangSymbol": "PL", "Value": "MDD" }
      ],
      "Child": {
        "Hierarchy_Id": "03",
        "Hierarchy_Symbol": "h2",
        "Description": [
          { "LangSymbol": "EN", "Value": "EXECUTIVE FURNITURE" },
          { "LangSymbol": "PL", "Value": "GABINETY" }
        ],
        "Child": {
          "Hierarchy_Id": "78",
          "Hierarchy_Symbol": "h3",
          "Description": [
            { "LangSymbol": "EN", "Value": "MITO" },
            { "LangSymbol": "PL", "Value": "MITO" }
          ],
          "Child": {
            "Hierarchy_Id": "99",
            "Hierarchy_Symbol": "h4",
            "Description": [
              { "LangSymbol": "EN", "Value": "MANAGERIAL DESK" },
              { "LangSymbol": "PL", "Value": "BIURKO MENEDŻERSKIE" }
            ],
            "Child": {
              "Hierarchy_Id": "86",
              "Hierarchy_Symbol": "h5",
              "Description": [
                { "LangSymbol": "EN", "Value": "MANAGERIAL DESK WITH STORAGE" },
                { "LangSymbol": "PL", "Value": "BIURKO Z SZAFKĄ MANAGERSKĄ" }
              ],
              "Child": null
            }
          }
        }
      }
    }
  },
  "Parameters": {
    "Width": 2080,
    "Lenght": 2190,
    "Height": 760,
    "Weight": 359.75,
    "Volume_of_packages": 1.295436,
    "Number_of_packages": 13,
    "AdditionalDimensions": [
      {
        "Width": 2080,
        "Lenght": 2190,
        "Height": 1300,
        "Dimension_Type": "ZW",
        "Dimension_Desc": "Zakres wysokości"
      }
    ]
  },
  "Attributes": [
    {
      "AttributeId": "1",
      "Symbol": "B1",
      "Name": [
        { "LangSymbol": "PL", "Value": "Kolor blatu" },
        { "LangSymbol": "EN", "Value": "Colour of the tabletop" }
      ],
      "Values_groups": [
        {
          "GroupID": 0,
          "Description": "Standard colours",
          "Name": [
            { "LangSymbol": "PL", "Value": "" }
          ],
          "Available_values": [
            {
              "Value": "0172",
              "Name": [
                { "LangSymbol": "PL", "Value": "Dąb bursztynowy" },
                { "LangSymbol": "EN", "Value": "Amber oak" }
              ],
              "AdditionalInfo": [
                { "LangSymbol": "PL", "Value": "" },
                { "LangSymbol": "EN", "Value": "" }
              ],
              "Gradation": [],
              "Surcharge": [],
              "SpecialSurcharge": 0,
              "MDDOnly": 0,
              "OriginalGroupDescription": "MFC / HPL",
              "OriginalGroupId": 500004,
              "DaysToComplete": 0
            }
          ]
        }
      ],
      "CouplingWithAttribute": "",
      "AvailableForStandardConfiguration": 1
    }
  ],
  "Price": [
    {
      "Price": 16500,
      "Currency": "PLN",
      "Currency_symbol": "zł",
      "PriceList_symbol": "Z1",
      "IsCommon": 1
    }
  ],
  "Ecotax": 0.0,
  "Comments": null,
  "LinxComments": [
    {
      "LangSymbol": "EN",
      "Value": "right-side managerial storage; leg + cabinet extension - white or black HPL high gloss"
    },
    {
      "LangSymbol": "PL",
      "Value": "szafka managerska po prawej stronie; noga + dostawka do szafki - biały lub czarny HPL połysk"
    }
  ],
  "AccessoriesGroups": [
    {
      "GroupID": 100016,
      "Description": "Podkładki do biurek",
      "Accessories": [
        {
          "Symbol": "S100",
          "Quantity": 0,
          "Definitions": [
            {
              "DefinitionNo": 1,
              "DefinitionParams": [],
              "DefinitionAttributeValues": []
            }
          ]
        }
      ],
      "Name": [
        { "LangSymbol": "EN", "Value": "Pads for desks" },
        { "LangSymbol": "PL", "Value": "Podkładki do biurek" }
      ]
    }
  ],
  "PriceGroup": "10",
  "IgnoreSurcharges": 0,
  "Gradation": 0,
  "ExecutionLog": [
    { "desc": "sku", "execution_time": 0 },
    { "desc": "parameters", "execution_time": 0 },
    { "desc": "attributes", "execution_time": 0 },
    { "desc": "price", "execution_time": 0 },
    { "desc": "accessories", "execution_time": 0 },
    { "desc": "comments", "execution_time": 0 },
    { "desc": "additional_dimensions", "execution_time": 0 },
    { "desc": "total_execution_time", "execution_time": 0 }
  ],
  "ExecutionFinishTime": "2025-12-01 11:10:22"
}

Sku string Required

Simbolo del prodotto (SKU).
IndexSAP string Required

Indice SAP in formato testo (con zeri iniziali).
Name array<object>

Nomi del prodotto in diverse lingue.
Name[].LangSymbol string Required

Possible values: PL EN DE ES FR IT

Codice lingua (due lettere, ad es. PL, EN, DE).
Name[].Value string Required

Nome del prodotto nella lingua specificata.
Hierarchy object

Albero gerarchico del catalogo in cui si trova il prodotto (ricorsivo Child -> Child -> ...).
Hierarchy.Child object

Nodo subordinato della gerarchia (ricorsivamente lo stesso schema: Child, Hierarchy_Id, Hierarchy_Symbol, Description).
Hierarchy.Child.Hierarchy_Id string

ID del nodo nella gerarchia (restituito come testo, ad es. "07").
Hierarchy.Child.Hierarchy_Symbol string

Simbolo del nodo nella gerarchia (ad es. h1, h2 ecc.).
Hierarchy.Child.Description array<object>

Descrizione del nodo in diverse lingue.
Parameters object

Parametri tecnici di base del prodotto.
Parameters.Width number

Larghezza in mm (o cm, a seconda del sistema di origine).
Parameters.Lenght number

Lunghezza in mm (il campo nell’API si chiama "Lenght").
Parameters.Height number

Altezza in mm.
Parameters.Weight number

Peso in kg.
Parameters.Volume_of_packages number

Volume dei colli (ad es. m³).
Parameters.Number_of_packages integer

Numero di colli.
Parameters.AdditionalDimensions array<object>

Dimensioni aggiuntive (ad es. intervallo di altezza).
Parameters.AdditionalDimensions[].Width number

Larghezza aggiuntiva.
Parameters.AdditionalDimensions[].Lenght number

Lunghezza aggiuntiva.
Parameters.AdditionalDimensions[].Height number

Altezza aggiuntiva.
Parameters.AdditionalDimensions[].Dimension_Type string

Tipo di dimensione aggiuntiva (ad es. "ZW").
Parameters.AdditionalDimensions[].Dimension_Desc string

Descrizione della dimensione aggiuntiva.
Attributes array<object>

Elenco degli attributi di configurazione del prodotto (ad es. colore del piano, tipo di gambe).
Attributes[].AttributeId string

Identificatore dell’attributo (restituito come testo, ad es. "1").
Attributes[].Symbol string

Simbolo dell’attributo (ad es. B1, C1 ecc.).
Attributes[].Name array<object>

Nomi dell’attributo in diverse lingue.
Attributes[].Values_groups array<object>

Gruppi di valori (opzioni disponibili per l’attributo).
Attributes[].Values_groups[].GroupID integer

Identificatore del gruppo di valori.
Attributes[].Values_groups[].Description string

Descrizione del gruppo di valori (ad es. "Colori standard").
Attributes[].Values_groups[].Name array<object>

Nomi dei gruppi di valori nelle diverse lingue.
Attributes[].Values_groups[].Available_values array<object>

Elenco dei valori specifici selezionabili (ad es. colori, tessuti).
Attributes[].Values_groups[].Available_values[].Value string

Codice a 4 cifre del valore in formato testo (ad es. "0172").
Attributes[].Values_groups[].Available_values[].Name array<object>

Nomi di un determinato valore in diverse lingue.
Attributes[].Values_groups[].Available_values[].AdditionalInfo array<object>

Informazioni aggiuntive (ad es. descrizione tecnica) in diverse lingue.
Attributes[].Values_groups[].Available_values[].Gradation array

Informazioni sulla gradazione/sequenza; in pratica spesso tabella vuota [].
Attributes[].Values_groups[].Available_values[].Surcharge array<object>

Elenco dei supplementi per un determinato valore (struttura come Price: Price, Currency, Currency_symbol, PriceList_symbol, IsCommon).
Attributes[].Values_groups[].Available_values[].SpecialSurcharge number

Sovrapprezzo speciale (valore numerico).

Default value: 0
Attributes[].Values_groups[].Available_values[].MDDOnly integer

Possible values: 0 1

Flag: valore disponibile solo per i clienti MDD (0 - no, 1 - sì).

Default value: 0
Attributes[].Values_groups[].Available_values[].OriginalGroupDescription string|null

Descrizione originale del gruppo nel sistema di origine.
Attributes[].Values_groups[].Available_values[].OriginalGroupId integer|null

Identificatore originale del gruppo nel sistema di origine.
Attributes[].Values_groups[].Available_values[].DaysToComplete integer|null

Giorni aggiuntivi necessari per l’esecuzione con questa configurazione.
Attributes[].CouplingWithAttribute string|null

Collegamento con un altro attributo (identificatore come stringa o vuoto, se mancante).
Attributes[].AvailableForStandardConfiguration integer

Possible values: 0 1

L’attributo è disponibile nelle configurazioni standard (0 - no, 1 - sì).

Default value: 0
Price array<object>

Elenco dei prezzi del prodotto in diversi listini e valute.
Price[].Price number

Prezzo numerico.
Price[].Currency string

Codice valuta nel formato ISO 4217 (ad es. EUR, PLN).
Price[].Currency_symbol string

Simbolo valuta (ad es. €, zł).
Price[].PriceList_symbol string

Simbolo listino prezzi.
Price[].IsCommon integer

Possible values: 0 1

Se il prezzo è comune? (0 - no, 1 - sì).

Default value: 0
Ecotax number

Valore ecotassa (ad es. percentuale o importo, secondo il sistema).
Comments string|null

Commenti testuali (se disponibili).
LinxComments array<object>

Commenti Linx in diverse lingue.
LinxComments[].LangSymbol string

Codice lingua del commento.
LinxComments[].Value string

Contenuto del commento nella lingua specificata.
AccessoriesGroups array<object>

Gruppi di accessori associati al prodotto.
AccessoriesGroups[].GroupID integer

ID del gruppo di accessori.
AccessoriesGroups[].Description string

Descrizione del gruppo di accessori.
AccessoriesGroups[].Accessories array<object>

Elenco degli accessori nel gruppo.
AccessoriesGroups[].Accessories[].Symbol string

Simbolo dell'accessorio.
AccessoriesGroups[].Accessories[].Quantity integer

Quantità predefinita dell'accessorio.

Default value: 0
AccessoriesGroups[].Accessories[].Definitions array<object>

Definizioni dell'accessorio (parametri, valori degli attributi).
AccessoriesGroups[].Accessories[].Definitions[].DefinitionNo integer

Numero di definizione dell'accessorio.
PriceGroup string

Simbolo del gruppo di prezzo del prodotto (ad es. "10").
IgnoreSurcharges integer

Possible values: 0 1

Flag di omissione dei supplementi (0 - no, 1 - sì).

Default value: 0
Gradation integer

Valore di gradazione a livello di prodotto.

Default value: 0
ExecutionLog array<object>

Log dei tempi di esecuzione delle singole fasi sul lato API.
ExecutionLog[].desc string

Descrizione della fase nel log di esecuzione.
ExecutionLog[].execution_time number

Tempo di esecuzione della fase (ad es. in ms).

Default value: 0
ExecutionFinishTime string

Timestamp di completamento della generazione della risposta (formato datetime).

JSON

{
  "status": 500,
  "error": "server_error",
  "message": "Si è verificato un errore del server."
}

Implementation

Esempi di chiamata dell'endpoint (GET anonimo, senza intestazione Authorization) per https://external-api.mddlinx.com/externalapi/configurator/{symbol}.

PHP

<?php
declare(strict_types=1);

$symbol = 'MIT1RP'; // simbolo del prodotto

$endpoint = 'https://external-api.mddlinx.com/externalapi/configurator/' . urlencode($symbol);

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_HTTPGET        => true,
    CURLOPT_HTTPHEADER     => [
        'Accept: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);

$body  = curl_exec($ch);
$errno = curl_errno($ch);
$error = curl_error($ch);
$http  = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($errno) {
    throw new RuntimeException($error);
}
if ($http < 200 || $http >= 300) {
    throw new RuntimeException('HTTP ' . $http . ': ' . $body);
}

$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Laravel

<?php
use Illuminate\Support\Facades\Http;

$symbol = 'MIT1RP';

$endpoint = 'https://external-api.mddlinx.com/externalapi/configurator/' . urlencode($symbol);

$response = Http::acceptJson()
    ->timeout(60)
    ->get($endpoint);

if ($response->failed()) {
    throw new RuntimeException('HTTP ' . $response->status() . ': ' . $response->body());
}

$config = $response->json();
print_r($config);

const symbol = 'MIT1RP';
const endpoint = `https://external-api.mddlinx.com/externalapi/configurator/${encodeURIComponent(symbol)}`;

(async () => {
  const res = await fetch(endpoint, {
    method: 'GET',
    headers: {
      'Accept': 'application/json'
    }
  });

  if (!res.ok) {
    throw new Error('HTTP ' + res.status + ': ' + (await res.text()));
  }

  const data = await res.json();
  console.log(data);
})();

Python

import requests
from urllib.parse import quote

symbol   = 'MIT1RP'
endpoint = 'https://external-api.mddlinx.com/externalapi/configurator/' + quote(symbol)

r = requests.get(
    endpoint,
    headers={
        'Accept': 'application/json',
    },
    timeout=60,
)
r.raise_for_status()

print(r.json())

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program {
  static async Task Main() {
    var symbol   = "MIT1RP";
    var endpoint = "https://external-api.mddlinx.com/externalapi/configurator/" + Uri.EscapeDataString(symbol);

    using var http = new HttpClient();
    http.DefaultRequestHeaders.Accept.ParseAdd("application/json");

    var res  = await http.GetAsync(endpoint);
    var body = await res.Content.ReadAsStringAsync();

    if (!res.IsSuccessStatusCode)
      throw new Exception("HTTP " + (int)res.StatusCode + ": " + body);

    Console.WriteLine(body);
  }
}

Richiesta prodotti

Offerta

Carrello

Endpoint

Request

Response

Implementation