Klassifikationsgruppen abrufen

URL

GET/pimapi/v1/classifications/{classificationId}/groups

Ruft eine paginierte Liste von Haupt- oder Unterklassifikationsgruppen ab, die einem bestimmten Klassifikationssystem zugeordnet sind.

---

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
classificationId	string	Ja	Eindeutige ID des Klassifikationssystems (z. B. ECLASS_10).

Abfrageparameter (Query-Parameter)

Parameter	Typ	Erforderlich	Standardwert	Beschreibung
languageId	string	Nein		Sprachkürzel zur Lokalisierung von Beschreibungen (z. B. en, de). Wenn weggelassen, werden alle übersetzten Werte zurückgegeben.
page	integer	Nein	0	Nullbasierte Seitennummer für die Paginierung.
pageSize	integer	Nein	20	Anzahl der pro Seite zurückzugebenden Elemente.

Hinweis

Standardmäßig werden die Ergebnisse aufsteigend nach der Sortiernummer der Gruppe sortiert (OrderNo: ASC).

---

Code-Beispiele

cURL

curl -X GET "https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/classifications/ECLASS_10/groups?page=0&pageSize=2" \
  -H "X-API-KEY: ihr_hex_api_schluessel" \
  -H "Accept: application/json"

JavaScript (Fetch)

const headers = new Headers();
headers.append("X-API-KEY", "ihr_hex_api_schluessel");
headers.append("Accept", "application/json");

fetch("https://dev.pxm.eu.prodexa.com/pxm/pimapi/v1/classifications/ECLASS_10/groups?page=0&pageSize=2", {
  method: 'GET',
  headers: headers
})
  .then(response => response.json())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

---

Antwortstruktur

HTTP 200 OK Antwort

Gibt ein paginiertes Payload-Wrapper-Objekt zurück, das eine Liste von Klassifikationsgruppen enthält.

{
  "status": 200,
  "meta": {
    "languageId": "de",
    "page": 0,
    "pageSize": 2,
    "totalElements": 24,
    "totalPages": 12,
    "sorting": "OrderNo: ASC"
  },
  "data": [
    {
      "classificationGroupId": "SCREWS",
      "shortDescription": [
        {
          "languageId": "de",
          "value": "Schrauben"
        }
      ],
      "fallbackDescShort": [
        {
          "languageId": "de",
          "value": "Schrauben"
        }
      ],
      "longDescriptions": [
        {
          "languageId": "de",
          "value": "Gewindeschrauben aus Metall und Verbindungselemente"
        }
      ],
      "documentUrl1": null,
      "documentUrl2": null,
      "documentUrl3": null,
      "orderNo": 10,
      "statusID": "ACTIVE",
      "attributes": [
        {
          "attributeId": "THREAD_SIZE",
          "attribute.description": [
            {
              "languageId": "de",
              "value": "Gewindegröße"
            }
          ]
        }
      ],
      "createdOn": "2026-06-15T09:00:00Z",
      "createdBy": "admin",
      "changedOn": "2026-06-17T11:00:00Z",
      "changedBy": "admin"
    },
    {
      "classificationGroupId": "NAILS",
      "shortDescription": [
        {
          "languageId": "de",
          "value": "Nägel"
        }
      ],
      "fallbackDescShort": [
        {
          "languageId": "de",
          "value": "Nägel"
        }
      ],
      "longDescriptions": [],
      "documentUrl1": null,
      "documentUrl2": null,
      "documentUrl3": null,
      "orderNo": 20,
      "statusID": "ACTIVE",
      "attributes": [],
      "createdOn": "2026-06-15T09:00:00Z",
      "createdBy": "admin",
      "changedOn": "2026-06-15T09:00:00Z",
      "changedBy": "admin"
    }
  ]
}

HTTP 404 Not Found Antwort

Wird zurückgegeben, wenn das Klassifikationssystem nicht existiert oder keine zugeordneten Gruppen hat.

{
  "status": 404,
  "meta": {
    "languageId": "de"
  },
  "error": "No Classification groups found"
}