Smarda API Anbindung

Inhaltsbereich

Die Smarda API kann benutzt werden, um einen Smarda-Shop oder eine Website an beliebige andere Systeme anzubinden. Dabei geht es oft um Warenwirtschaftsysteme (WaWi), ERP-Systeme, CRM-Systeme, Buchhaltung oder auch um Middleware. Es spielt dabei keine Rolle, ob es sich um große, gängige Systeme (wie SAP, Odoo, JTL, BMD, Hubspot, Pipedrive, Datev, Zapier usw.) oder spezielle, individuell entwickelte Apps handelt. Mittels der API Dokumentation können Entwickler auf Smarda zugreifen und jede Art von Datenaustausch steuern.

Smarda ist nach dem API-First-Prinzip aufgebaut, dadurch kann man über die API jede Änderung vornehmen, die einem User über das Backend möglich ist.

Jeder API Aufruf passiert über folgende Basis-Adresse:

{{pre}} {{code class="language-markup"}}
Base URL: https://api.smarda.app/backend/
{{/code}} {{/pre}}

An diese Basis-Adresse wird dann der Name des jeweiligen Endpoints angehängt. Um Produkte abzufragen rufst du zum Beispiel

{{pre}} {{code class="language-markup"}}
GET https://api.smarda.app/backend/shops/{{shopId}}/products
{{/code}} {{/pre}}

auf. Du findest alle Endpoint-Namen in unserer API Referenz beschrieben.

Bevor du aber die Endpoints abfragen kannst, brauchst du ein Access-Token, das du in jedem Request mitsenden musst. Du erhältst einen POST Request an folgenden Endpoint:

{{pre}} {{code class="language-markup"}}
POST https://api.smarda.app/backend/auth/token
{{/code}} {{/pre}}

Zurück bekommst du dann eine Antwort in dieser Art:

{{pre}} {{code class="language-json"}}
{
    "token": "CaFBd6ukUgj6bxr2r0uBYj1pyTD7yDkG1s08AewjOOIgdrP",
    "jwt": null,
    "createdAt": "2025-01-14 15:22:58",
    "validUntil": "2025-01-15 15:22:58"
}
{{/code}} {{/pre}}

Den Wert, der im Property "token" zurückkommt, gibst du bei allen Folge-Request mit an. 

Beispiel: Abfrage der Produkte

{{pre}} {{code class="language-markup"}}
GET https://api.smarda.app/backend/shops/{{shopId}}/products

Authorization: Bearer CaFBd6ukUgj6bxr2r0uBYj1pyTD7yDkG1s08AewjOOIgdrP
{{/code}} {{/pre}}

Die API Referenz findest du unter: https://developer.smarda.com/api/doc/reference/shop/