REST 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.

API-Referenz öffnen
NetSeller API200 OK
GET/api/v1/products
shopId=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
  • 14Berechtigungsbereiche
  • CHShop-Kontext
API-ClientsRechte · Shops · Schlüssel

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 versionierte API umfasst lesende und schreibende Endpunkte für Katalog, Lager, Checkout, Bestellungen, Kunden, Marketing, Einstellungen und Webhooks.

01

Katalog

Produkte, Varianten, Kategorien, Medien, Preise und Beziehungen austauschen.

catalog:read · catalog:write
02

Lager & Checkout

Bestände führen sowie Warenkörbe und Checkout-Abläufe serverseitig steuern.

inventory:read · inventory:write · checkout:write
03

Bestellungen

Aufträge, Status, Dokumente, Rückerstattungen und Sendungen bearbeiten.

orders:read · orders:write
04

Kunden & Firmen

Profile, Adressen, Firmen, Mitglieder und Shop-Zuordnungen pflegen.

customers:read · customers:write
05

Marketing & Shops

Coupons, Gutscheine, Preisaktionen und öffentliche Shop-Einstellungen anbinden.

marketing:read · marketing:write · settings:read
06

Webhooks & Vertrag

Ereignisse signiert zustellen und alle Operationen im OpenAPI-Vertrag nachschlagen.

webhooks:read · webhooks:write

03 / 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
  1. 01API-Client
  2. 02Shop
  3. 03Sprache
  4. 04Währung
  5. 05Preisliste
  6. ✓passende Daten

04 / SICHERHEIT

Nur so offen wie nötig.

Ein API-Client sieht ausschliesslich die zugewiesenen Bereiche und Shops. Die Authentisierung erfolgt über Bearer-Schlüssel, deren Wert nur bei der Erstellung angezeigt wird.

catalog:readcatalog:writeinventory:readinventory:writeorders:readorders:writecustomers:readcustomers:writemarketing:readmarketing:writecheckout:writesettings:readwebhooks:readwebhooks:write
Berechtigungen14 Bereiche · 2 Shops

05 / BEISPIEL

Ein Request.
Klare Antwort.

API-Aufrufe gehen an die jeweilige NetSeller-Installation; api.netseller.net stellt ausschliesslich die Referenz bereit. Der echte Schlüssel gehört in die geschützte Konfiguration der angebundenen Anwendung.

curl "https://shop.example.com/api/v1/products?shopId=1&language=de&currency=CHF" \
  -H "Authorization: Bearer YOUR_API_KEY"
200 OK{ "data": [ ... ], "meta": { ... }, "errors": [] }

06 / ARCHITEKTUR

Kontrollierter Zugang. Keine offene Datenbank.

Die API bildet einen versionierten Vertrag zwischen NetSeller und angebundenen Systemen. Die öffentliche Referenz beschreibt alle verfügbaren Operationen, Eingaben, Antworten und Fehler direkt aus der produktiven OpenAPI-Spezifikation.

Vollständige API-Referenz