Für Händler und Distributoren

Unser Bestand, direkt abrufbar

Wer regelmäßig bei uns einkauft, soll nicht auf eine Liste per Mail warten müssen. Nach Freischaltung lesen Sie den verfügbaren Bestand direkt aus der Schnittstelle — dieselbe Datenbasis, die auch unser Lager führt.

Zugang beantragen Zur Dokumentation

Zugang

Drei Schritte, einer davon von Hand

Es gibt keinen Selbstbedienungszugang. Wir schalten jeden Zugang einzeln frei — weil hinter den Daten unser echter Lagerbestand mit echten Preisen steht.

1 · Antrag

Formular mit Firmendaten und USt-IdNr. Wir prüfen die Nummer und ordnen Ihr Unternehmen zu.

2 · Prüfung von Hand

Wir sehen uns an, wer fragt, und melden uns bei Rückfragen. In der Regel am nächsten Werktag entschieden.

3 · Token

Sie erhalten einen persönlichen Token per E-Mail. Er gilt bis auf Widerruf und kann jederzeit getauscht werden.

Lieber eine Oberfläche als eine Schnittstelle? Dann nutzen Sie den B2B-Shop — gleiche Daten, gleicher Bestand, nur zum Anklicken statt zum Abrufen. Der Zugang wird gemeinsam freigeschaltet.

Dokumentation

Endpunkte

Basis-Adresse https://api.smd-tech.de/v1 · Authentifizierung über den Kopfzeilen-Wert X-API-Token · Antworten immer als JSON, Zeichensatz UTF-8.

Aufruf	Beschreibung
`GET /bestand`	Alle verfügbaren Artikel. Ein Artikel ist die Kombination aus Modell, Speicher, Farbe und Zustandsklasse — mit der Menge, die tatsächlich frei ist.
`GET /bestand/:artikel`	Ein einzelner Artikel über seine Kennung.
`GET /status`	Erreichbarkeit, Stand der Daten und Ihr verbleibendes Abrufkontingent. Gut zum Prüfen des Tokens.

Filter für `GET /bestand`

Parameter	Typ	Wirkung
`typ`	Text	Gerätetyp, z. B. `smartphone`, `tablet`, `notebook`.
`modell`	Text	Teilstring, ohne Beachtung von Groß- und Kleinschreibung. `modell=iphone%2013` findet alle Varianten.
`grade`	Text	Zustandsklasse. Derzeit wird über die Schnittstelle nur `A` ausgegeben.
`farbe`	Text	Farbe wie im Bestand geführt.
`min_menge`	Ganzzahl	Nur Artikel mit mindestens dieser freien Menge.
`limit`, `offset`	Ganzzahl	Blättern. `limit` höchstens 500, Voreinstellung 100.

Beispiel

# Alle verfügbaren iPhone 13 mit mindestens 5 Stück
curl -s 'https://api.smd-tech.de/v1/bestand?modell=iphone%2013&min_menge=5' \
     -H 'X-API-Token: ihr-token'

{
  "stand": "2026-07-25T18:40:12Z",
  "anzahl": 2,
  "artikel": [
    {
      "artikel":    "iphone-13-128-schwarz-a",
      "typ":        "smartphone",
      "modell":     "Apple iPhone 13",
      "speicher":   "128 GB",
      "farbe":      "Schwarz",
      "grade":      "A",
      "menge":      14,
      "preis":      289.00,
      "waehrung":   "EUR"
    }
  ]
}

Regeln

Kontingent. 60 Abrufe je Minute und Token. Wird es überschritten, antwortet die Schnittstelle mit 429 und nennt die Wartezeit.
Menge ist die freie Menge. Was in einer offenen Bestellung reserviert ist, wird nicht mitgezählt. Damit ist die Zahl belastbar, aber sie kann sich jederzeit ändern — eine Zusage ist erst die Bestellbestätigung.
Preise sind Nettopreise in Euro, ohne Versand, gültig zum Zeitpunkt des Abrufs.
Token gehört Ihnen allein. Er darf nicht in einer Anwendung landen, die im Browser läuft — dort ist er für jeden lesbar. Bei Verdacht tauschen wir ihn sofort.
Fehler sprechen Deutsch. Antworten mit 4xx enthalten ein Feld fehler mit einem verständlichen Satz, nicht nur einen Code.

Antrag

Zugang beantragen

Wir schalten Zugänge nur für Unternehmen frei, die tatsächlich einkaufen wollen. Sagen Sie uns kurz, wofür Sie die Daten brauchen — das beschleunigt die Prüfung.

Was wir prüfen

Gültigkeit der USt-IdNr. und Übereinstimmung mit dem Firmennamen
Ob ein nachvollziehbarer Einkaufsbedarf besteht
Erreichbarkeit über die genannten Kontaktdaten

Schon Kunde?

Wenn Sie bereits bei uns einkaufen, geht es schneller — schreiben Sie kurz an info@smd-tech.de mit dem Hinweis auf Ihre Kundennummer.

Fragen

Häufig gefragt zur Schnittstelle

Wie aktuell sind die Daten?

Der Abruf liest direkt aus unserer Warenwirtschaft. Es gibt keinen Zwischenspeicher, der über Nacht aktualisiert wird — der Stand steht in jeder Antwort im Feld stand.

Warum nur Zustandsklasse A?

Weil wir mit einer klaren Klasse anfangen und die Beschreibung sauber halten wollen. Andere Klassen liefern wir auf Anfrage — sprechen Sie uns an, dann schalten wir sie für Ihren Token frei.

Können wir über die Schnittstelle auch bestellen?

Derzeit nicht. Die Schnittstelle liest. Bestellungen laufen über den Shop oder direkt über Ihren Ansprechpartner. Ein Bestell-Endpunkt ist geplant — sagen Sie uns, wenn Sie ihn brauchen, das beeinflusst die Reihenfolge.

Was passiert bei Wartungsarbeiten?

Dann antwortet die Schnittstelle mit 503 und einer Angabe, wie lange voraussichtlich. Geplante Arbeiten kündigen wir den Zugangsinhabern vorher an.

Bekommen wir Bilder zu den Artikeln?

Über die Schnittstelle nicht. Im Shop sind Modellbilder hinterlegt. Wenn Sie Bilder für Ihren eigenen Shop brauchen, sprechen Sie uns an.

Regelmäßiger Bedarf?

Dann ist die Schnittstelle der ruhigste Weg — Ihr System fragt, unser Lager antwortet.

Zugang beantragen Zum B2B-Shop +49 176 6486 0639