REST API (kopflos)

Überblick über Shoporama

Die REST-API von Shoporama ermöglicht Ihnen die Integration Ihres Online-Shops mit externen Systemen - ERP, Bestandsmanagement, PIM, CRM und andere Dienste. Die API unterstützt vollständiges CRUD (Erstellen, Lesen, Aktualisieren, Löschen) für die meisten Ressourcen.

Los geht's

1. Gehen Sie zu Einstellungen → API in Ihrer Shoporama-Verwaltung
2. Erstellen Sie einen neuen API-Schlüssel
3. Wählen Sie die Rechte: Lesen, Schreiben oder Vollzugriff
4. Verwenden Sie den Schlüssel in der Kopfzeile Autorisierung

Authentifizierung

Fügen Sie Ihren API-Schlüssel in der Kopfzeile Autorisierung ein:

Autorisierung: YOUR-API-KEY

Verfügbare Ressourcen

Die API bietet Zugang zu den folgenden Ressourcen:

Produkte und Katalog

• /REST/product - Produkte (mit Varianten, Bildern, Preisen, Kategorien)
• /REST/kategorie - Kategorien
• /REST/brand - Marken
• /REST/manufacturer - Hersteller
• /REST/lieferant - Lieferanten
• /REST/stock - Lagerbestand
• /REST/profile / /REST/profile-attribute - Produktprofile und -attribute

Aufträge und Kunden

• /REST/order - Bestellungen
• /REST/order-return - Retouren
• /REST/customer - Kunden
• /REST/voucher - Rabattcodes

Inhalt /REST/blog-entry

• /REST/blog-post - Blog-Einträge
• /REST/page - Seiten
• /REST/landing-page - Landingpages
• /REST/menu - Navigation

Einrichtung /REST/setup

• /REST/shipping - Versandmethoden
• /REST/payment-gateway - Zahlungsmöglichkeiten
• /REST/country - Länder
• /REST/redirect - URL-Weiterleitungen
• /REST/webhook - Webhaken

HTTP-Methoden

Methode	Aktion	Beispiel: GET
GET	Ressource(n) abrufen	GET /REST/Produkt
POST	Ressource erstellen	POST /REST/Produkt
PUT	Ressource aktualisieren	PUT /REST/Produkt/123
DELETE	Ressource löschen	DELETE /REST/Produkt/123

Beispiel: Produkte abrufen

curl -H "Autorisierung: IHR-API-KEY" \ https://dinshop.dk/REST/product?limit=10

Beispiel: Inventar aktualisieren

curl -X PUT -H "Autorisierung: IHR-API-KEY" \ -H "Content-Type: application/json" \ -d '{"stock": 50}' \ https://dinshop.dk/REST/product/123

Filtern und Paging

Die meisten Listenendpunkte unterstützen:

• ?limit=25 - Anzahl der Ergebnisse pro Seite (max. 100)
• ?offset=0 - überspringt eine Anzahl von Ergebnissen
• ?search=text - freie Textsuche
• ?fields=name,price - Begrenzung der zurückgegebenen Felder
• ?last_modified=2026-01-01 - nur Änderungen seit dem Datum

Webhooks

Sie können über die API Webhooks erstellen, damit Ihr System automatisch benachrichtigt wird, wenn Änderungen auftreten:

POST /REST/webhook { "url": "https://dit-system.dk/webhook", "events": ["order", "product", "stock"] }

Bei der Erstellung erhalten Sie ein Geheimnis, das zur Verifizierung von Webhook-Aufrufen über HMAC verwendet wird.

Ratenbegrenzung

Jeder API-Schlüssel hat ein tägliches Limit für die Anzahl der Aufrufe. Der Standardwert ist 10.000 Aufrufe pro Tag. Wenn das Limit überschritten wird, wird HTTP 429 zurückgegeben. Sie können Ihre Nutzung sehen und das Limit unter Einstellungen → API anpassen.

Antwortcodes

• 200 - Erfolg
• 201 - Ressource erstellt
• 204 - Aktualisierung/Löschung erfolgreich
• 400 - Ungültige Anfrage
• 401 - Nicht autorisiert (falscher API-Schlüssel)
• 404 - Ressource nicht gefunden
• 429 - Ratenlimit überschritten

Benötigen Sie Hilfe bei der API-Integration? Kontaktieren Sie uns unter support@shoporama.dk.