Katalog
Produkte, Varianten, Kategorien, Hersteller, Merkmale, Preise und Lieferzeiten.
catalog:readREST API / JSON
Commerce-Daten.
Klar angebunden.
NetSeller stellt zentrale Shop-Daten über definierte Ressourcen bereit. API-Clients erhalten genau die Rechte, Shops und Kontexte, die ihre Aufgabe benötigt.
Ressourcen ansehenNetSeller API200 OK
GET
/api/v1/productsshopId=1language=decurrency=CHF
{
"data": [{
"id": 1042,
"sku": "AB-FJ-01",
"name": "Fleecejacke Tannengrün",
"hasVariants": true,
"availability": { "status": "in_stock" },
"price": { "amount": "129.00", "currency": "CHF" }
}],
"errors": []
}- RESTklare Endpunkte
- JSONstrukturierte Antworten
- 05Berechtigungsbereiche
- CHShop-Kontext
01 / ZUGANG
Ein Zugang.
Klare Rechte.
Jede Anbindung erhält einen eigenen API-Client. Status, Berechtigungen, Shop-Zuordnung und Schlüssel-Metadaten bleiben zentral sichtbar.
- Clients einzeln aktivieren oder deaktivieren
- Zugriff auf ausgewählte Shops begrenzen
- Schlüssel widerrufen und Verwendung prüfen
02 / RESSOURCEN
Was die API verbindet.
Die aktuelle Ausbaustufe umfasst die lesenden GET-Endpunkte. Schreibende Endpunkte sind vorgesehen und werden mit der weiteren Entwicklung schrittweise ergänzt.
Lager
Bestände und Verfügbarkeit für Produkte und Varianten auslesen.
inventory:readBestellungen
Aufträge, Positionen, Status, Dokumente und Trackinginformationen auslesen.
orders:readKunden
Privatkunden, Firmen, Adressen und Kundengruppen strukturiert abrufen.
customers:readShops
Sprachen, Währungen, Länder, Versand- und Zahlungsarten je Shop lesen.
settings:readEin Vertrag
Einheitliche Antworten mit Daten, Metadaten, Fehlern und Request-ID.
data · meta · errors03 / COMMERCE-KONTEXT
Daten, die zum Shop passen.
Produkte und Preise lassen sich im gewünschten Shop-, Sprach-, Währungs- und Preislisten-Kontext abfragen. So bleibt eine Anbindung auch im Multishop-Betrieb eindeutig.
GET /products?
shopId=1language=decurrency=CHFpriceListId=2- 01API-Client
- 02Shop
- 03Sprache
- 04Währung
- 05Preisliste
- ✓passende Daten
05 / BEISPIEL
Ein Request.
Klare Antwort.
Die Beispiele verwenden bewusst einen Platzhalter. Der echte Schlüssel gehört ausschliesslich in die geschützte Konfiguration der angebundenen Anwendung.
curl "https://shop.example/api/v1/products?shopId=1&language=de¤cy=CHF" \
-H "Authorization: Bearer YOUR_API_KEY"const response = await fetch(
"https://shop.example/api/v1/products?shopId=1&language=de¤cy=CHF",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const payload = await response.json();cfhttp(
url = "https://shop.example/api/v1/products?shopId=1&language=de¤cy=CHF",
method = "get",
result = "apiResponse"
) {
cfhttpparam(
type = "header",
name = "Authorization",
value = "Bearer YOUR_API_KEY"
);
}
payload = deserializeJSON(apiResponse.fileContent);200 OK
{ "data": [ ... ], "meta": { ... }, "errors": [] }06 / ARCHITEKTUR
Kontrollierter Zugang. Keine offene Datenbank.
Die API bildet einen stabilen Vertrag zwischen NetSeller und angebundenen Systemen. Der aktuelle Stand konzentriert sich auf GET-Endpunkte; schreibende Abläufe und weitere Ressourcen folgen im nächsten Ausbau.
API-Anbindung besprechen