Smarda API Anbindung

Die Smarda API kann benutzt werden, um einen Smarda-Shop oder eine Website an beliebige andere Systeme anzubinden. 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/