Preislisten API

Dokumentation & Zugang beantragen

Übersicht

Die API gibt Preislistendaten im JSON-Format zurück. Der Zugriff ist nur mit einem gültigen, freigegebenen API-Key möglich. Je nach Key wird automatisch die zugehörige Preisliste geladen.

API-Key beantragen

Tragen Sie Ihre Angaben ein. Nach der Übermittlung wird Ihr Antrag vom Admin geprüft und freigegeben.

Nach der Freigabe durch den Administrator erhalten Sie eine E-Mail mit Ihrem persönlichen API-Key.

Authentifizierung

Der API-Key wird mit jeder Anfrage mitgeschickt — entweder im HTTP-Header (empfohlen) oder als URL-Parameter:

GET Via Authorization-Header

GET https://data.innodis.ch/api.php
Authorization: Bearer IHR_API_KEY

GET Via URL-Parameter

GET https://data.innodis.ch/api.php?api_key=IHR_API_KEY

Endpunkte

GET Alle Einträge

https://data.innodis.ch/api.php?api_key=IHR_API_KEY
200 OK 401 Ungültiger Key 403 Key nicht freigegeben

GET Nur eine bestimmte Preisliste

Falls Sie Zugriff auf mehrere Preislisten haben, können Sie mit preisliste gezielt eine davon abrufen. Der Wert entspricht dem internen Schlüssel der Preisliste (z. B. haendler). 

https://data.innodis.ch/api.php?api_key=IHR_API_KEY&preisliste=haendler
200 OK 403 Kein Zugriff auf diese Preisliste

GET Suche über alle Spalten

https://data.innodis.ch/api.php?api_key=IHR_API_KEY&search=Begriff
200 OK

POST API-Key beantragen

POST https://data.innodis.ch/register.php
Content-Type: application/json

{ "email": "info@firma.ch", "name": "Firma XY" }
201 Antrag eingereicht 400 Ungültige Eingabe 409 E-Mail bereits registriert

Antwort-Format

Alle Antworten sind JSON. Erfolgreiche Datenanfragen liefern:

{
  "source": "Firma XY",
  "preislisten": ["Händler-Preisliste", "Sonderpreise"],
  "count": 42,
  "data": [
    { "Artikelnummer": "1234", "Bezeichnung": "...", "Preis": "12.50", "_preisliste": "Händler-Preisliste" },
    ...
  ]
}

Die Spaltenbezeichnungen entsprechen der ersten Zeile der jeweiligen Excel-Datei. Das Feld _preisliste gibt bei jedem Eintrag an, aus welcher Preisliste er stammt. preislisten listet alle in der Antwort enthaltenen Preislisten auf.

Fehlerformat

{ "error": "Beschreibung des Fehlers" }