Katalog
Produkte, Varianten, Kategorien, Medien, Preise und Beziehungen austauschen.
catalog:read · catalog:writeREST API / JSON
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/api/v1/products{
"data": [{
"id": 1042,
"sku": "AB-FJ-01",
"name": "Fleecejacke Tannengrün",
"hasVariants": true,
"availability": { "status": "in_stock" },
"price": { "amount": "129.00", "currency": "CHF" }
}],
"errors": []
}
01 / ZUGANG
Jede Anbindung erhält einen eigenen API-Client. Status, Berechtigungen, Shop-Zuordnung und Schlüssel-Metadaten bleiben zentral sichtbar.
02 / RESSOURCEN
Die versionierte API umfasst lesende und schreibende Endpunkte für Katalog, Lager, Checkout, Bestellungen, Kunden, Marketing, Einstellungen und Webhooks.
Produkte, Varianten, Kategorien, Medien, Preise und Beziehungen austauschen.
catalog:read · catalog:writeBestände führen sowie Warenkörbe und Checkout-Abläufe serverseitig steuern.
inventory:read · inventory:write · checkout:writeAufträge, Status, Dokumente, Rückerstattungen und Sendungen bearbeiten.
orders:read · orders:writeProfile, Adressen, Firmen, Mitglieder und Shop-Zuordnungen pflegen.
customers:read · customers:writeCoupons, Gutscheine, Preisaktionen und öffentliche Shop-Einstellungen anbinden.
marketing:read · marketing:write · settings:readEreignisse signiert zustellen und alle Operationen im OpenAPI-Vertrag nachschlagen.
webhooks:read · webhooks:write03 / COMMERCE-KONTEXT
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.
shopId=1language=decurrency=CHFpriceListId=205 / BEISPIEL
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¤cy=CHF" \
-H "Authorization: Bearer YOUR_API_KEY"const response = await fetch(
"https://shop.example.com/api/v1/products?shopId=1&language=de¤cy=CHF",
{ headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const payload = await response.json();<?php
$client = curl_init(
"https://shop.example.com/api/v1/products?shopId=1&language=de¤cy=CHF"
);
curl_setopt_array($client, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: Bearer YOUR_API_KEY"]
]);
$payload = json_decode(curl_exec($client), true);import requests
response = requests.get(
"https://shop.example.com/api/v1/products?shopId=1&language=de¤cy=CHF",
headers={"Authorization": "Bearer YOUR_API_KEY"},
)
payload = response.json()import java.net.URI;
import java.net.http.*;
var request = HttpRequest.newBuilder()
.uri(URI.create("https://shop.example.com/api/v1/products?shopId=1&language=de¤cy=CHF"))
.header("Authorization", "Bearer YOUR_API_KEY")
.build();
var response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());using System.Net.Http.Headers;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "YOUR_API_KEY");
var payload = await client.GetStringAsync(
"https://shop.example.com/api/v1/products?shopId=1&language=de¤cy=CHF"
);cfhttp(
url = "https://shop.example.com/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);request, _ := http.NewRequest(
http.MethodGet,
"https://shop.example.com/api/v1/products?shopId=1&language=de¤cy=CHF",
nil,
)
request.Header.Set("Authorization", "Bearer YOUR_API_KEY")
response, err := http.DefaultClient.Do(request)
if err != nil { log.Fatal(err) }
defer response.Body.Close(){ "data": [ ... ], "meta": { ... }, "errors": [] }06 / ARCHITEKTUR
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