REST-API

Ü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 CRUD (Erstellen, Lesen, Aktualisieren, Löschen) für die meisten Ressourcen in Ihrem Online-Shop.

Dokumentation

Die vollständige API-Dokumentation mit allen Endpunkten, Parametern und Beispielen finden Sie in unserer interaktiven Swagger-Dokumentation:

Öffnen Sie die Swagger-Dokumentation

Hier können Sie API-Aufrufe direkt im Browser testen und alle verfügbaren Felder und Parameter für jede Ressource sehen.

Starten Sie

1. Gehen Sie zu Einstellungen → API in Ihrer Shoporama-Verwaltung
2. Erstellen Sie einen neuen API-Schlüssel
3. Wählen Sie Rechte für den Schlüssel - Sie können Lese- und/oder Schreibzugriff auf jede Ressource gewähren
4. Verwenden Sie den Schlüssel im Autorisierungs-Header Ihrer API-Aufrufe

Authentifizierung

Fügen Sie Ihren API-Schlüssel in den Autorisierungs-Header ein. Sie können den Schlüssel entweder direkt senden oder das Bearer-Format verwenden:

Authorisation: YOUR-API-KEY # Oder mit Bearer: Authorisation: Bearer YOUR-API-KEY

Verfügbare Ressourcen

Die API bietet Zugang zu den folgenden Ressourcen. Auf alle Endpunkte wird unter https://dinshop.dk/REST/ zugegriffen:

Produkte und Katalog

• /product - Produkte (mit Varianten, Bildern, Preisen, Kategorien, Zusatzfeldern)
• /category - Kategorien
• /brand - Marken/Handelsmarken
• /Hersteller - Hersteller
• /Lieferant - Lieferanten
• /product-label - Produktbezeichnungen
• /profil, /profil-attribut, /profil-attribut-wert - Produktprofile, Attribute und Werte

Lagerbestand

• /stock - Bestände und Buchungen
• /batch - Bestandschargen

Aufträge und Kunden

• /order - Bestellungen
• /order/{id}/create-label - Versandetikett auf Bestellung erstellen
• /order/{id}/download-label - Versandetikett herunterladen
• /order-queue - Auftragswarteschlange
• /order-label - Etiketten für Bestellungen
• /order-return - Rücksendungen
• /customer - Kunden
• /customer-field - Kundenfelder
• /voucher - Rabattcodes und Geschenkgutscheine

Inhalt /page - Statische Seiten

• /page - Statische Seiten
• /blog-post - Blog-Beiträge
• /landing-page und /landing-page-item - Landing Pages und Elemente
• /menu - Menüs und Navigation

/newsletter-list - Rundbriefe

• /newsletter-list - Newsletter-Listen
• /newsletter-subscriber - Abonnenten
• /newsletter-kampagne - Kampagnen

Einrichtung - Einrichtung

• /shipping - Versandmethoden
• /payment_gateway - Zahlungsarten
• /country - Länder
• /redirect - URL-Weiterleitungen
• /webhook - Webhaken

Theme-Dateien

• /theme-file - Lesen, Erstellen, Aktualisieren und Löschen von Dateien in Ihren Themen. Erfordert die Aktivierung von "Zugriff auf Themendateien" im API-Schlüssel

HTTP-Methoden

• GET - Abrufen einer Liste oder einer einzelnen Ressource
• POST - Erstellen einer neuen Ressource
• PUT - Aktualisieren einer vorhandenen Ressource
• DELETE - Löschen einer Ressource

Beispiele für diese Methoden

Produkte abrufen:

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

Ein Produkt erstellen:

curl -X POST -H "Authorisation: YOUR-API-KEY" \ -H "Content-Type: application/json" \ -d '{"name": "New Product", "price": 199.00}' \ https://dinshop.dk/REST/product

Bestand aktualisieren:

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

Filtern und Paging

Listenendpunkte unterstützen die folgenden Abfrageparameter:

• ?limit=25 - Anzahl der Ergebnisse pro Seite (max. 100)
• ?offset=0 - Überspringen von Ergebnissen (für Paging)
• ?search=text - Freitextsuche
• ?fields=name,price - Begrenzung der zurückgegebenen Felder
• ?last_modified=2026-01-01 - nur Ressourcen, die seit dem Datum geändert wurden

Webhooks

Sie können über die API Webhooks erstellen, damit Ihr System automatisch benachrichtigt wird, wenn Änderungen vorgenommen werden. Bei der Erstellung erhalten Sie ein Geheimnis, das zur Verifizierung von Webhook-Aufrufen über HMAC verwendet wird.

Antwortcodes

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

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